The Smartling Translation API is a REST-like API that allows you to access functionality provided by the Smartling Translation Management Platform using defined HTTPS requests and structured JSON responses. You can integrate translated content files into your application by simply uploading source content files, Smartling will handle the translations, and then you can download the translated files whenever it makes sense (most likely during deployment). You can always check the status of a file or get a list of files in translation.

To make things even easier, for several languages, Smartling has created SDKs. This means you don't even need to worry about low-level API details. Just download our artifacts and integrate the API in your build process. Simple.

Base URL

All URLs within this documentation have the following base:



Smartling Translation API requests must be served over HTTPS. This ensures data privacy which is not provided by HTTP.


File encoding is specified in the header for the content-type by specifying a charSet; for example:

Content-Type: text/html; charset=utf-8 

The Smartling Translation API supports UTF-8, UTF-16, US-ASCII, and ISO-8859-1 (aka Latin-1) encoding.

Date Format

All dates will follow the common ISO 8601 date and time standard format, and will be expressed in UTC:


For example, 10:31 PM UTC on Saturday, August 21, 2010 would be:



Every API request you make must include both an API key and projectId. These credentials must be kept secure and can be found in your Smartling dashboard at: https://dashboard.smartling.com/settings/api


If you don't find all the answers you need in the API documentation, contact support at support@smartling.com or log a ticket with the Smartling Help Desk via support.smartling.com. You can keep current by following us at blog.smartling.com or on Twitter @smartling.