L10n.ws logo L10n.ws

HTTP API version 1

The L10n API allows developers to work with message bundles via HTTP protocol.

Base URL


Request and response formats

The L10n API uses HTTP GET requests with URL parameters and JSON responses. Every string passed from the API is UTF-8 encoded.


Authorized requests to the API should use an Access-Token header with the value , where is an access token.

Error handling

Errors are returned using standard HTTP error code syntax. Any additional info is included as JSON in the body of the response.

Standard API errors

Code Description
400 Bad input parameter. Error message should indicate which one and why.
401 Bad or expired token. This can happen if the access token is expired or if the access token has been revoked by L10n or the user.
405 Request method not expected.
429 Your app is making too many requests for the given user or team and is being rate limited. Your app should wait for the number of seconds specified in the “Retry-After” response header before trying again.
5xx An error occurred on the L10n servers.




Returns all messages.

URL Structure





Name Required/Optional Type Description
b required String Bundle key
v required String Version name
l[] optional Array Locales array


  "defaultLocale": "en_US",
  "supportedLocales": "en_US",
  "content": [
      "locale": "en_US",
      "messages": [
          "key": "foo",
          "value": "bar"
          "key": "biz",
          "value": "baz"


A JSON-encoded dictionary including defaultLocale field and content. Content is a array of all locales with messages in selected bundle.