Lokalise uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 3xx indicate redirects. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a charge failed, etc.). Codes in the 5xx range indicate an error with Lokalise servers (these are rare).



200 - OK

Everything worked as expected.

208 - Already Reported

The posted resource was already added.

400 - Bad Request

The request was unacceptable, often due to missing a required parameter.

401 - Unauthorized

No valid API key provided.

403 - Forbidden

Authenticated user is not granted to perform requested action.

404 - Not Found

The requested resource does not exist.

406 - Not Acceptable

The posted resource is malformed or broken.

409 - Conflict

The request conflicts with another request (perhaps due to using the same idempotent key).

429 - Too Many Requests

Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.

500, 502, 503, 504 - Server Errors

Something went wrong on Lokalise end. (These are rare.)

The Error object

  • code (number) — error code.
  • message (string) — custom error message providing additional information.