Error Handling

The endpoints return standard HTTP status codes. The list of status includes:

Code	Meaning
200	Success
400	Bad request
401	Unauthorized
403	Forbidden
404	Not found
500	Internal server error

Example 400 Response

{
  "message": "Unsupported country code"
}

Example 401 Response

{
    "error_description": "The access token is invalid or has expired",
    "error": "invalid_token"
}

In case of an error (4xx or 5xx status), the response body generally has the following structure:

Field	Description	Type
message	Description of the error condition intended for a human audience	string

Note though that some authentication errors might have a slightly different structure:

Field	Description	Type
error_description	Description of the error condition intended for a human audience	string
error	Error category	string