Error Responses

Errors in the 4xx and 5xx range return a standard JSON format indicating the reason for the error along with additional contextual information.

For requests that fail with a response code of 400, the invalid key will have more information about which parameter(s) caused the request to fail.

The Error Object

{
    "code": "400",
    "type": "INVALID_REQUEST_ERROR",
    "message": "The request was invalid.",
    "invalid": [{
        "name": "limit",
        "reason": "Limit must be less than 500."
    }]
}

Error Codes

Code	Type	Reason
400	INVALID_REQUEST_ERROR	The request was invalid. Check the invalid key for information about which parameters caused the error.
402	PAYMENT_REQUIRED_ERROR	The credentials used are valid but the account is canceled or unpaid. Contact support for more info.
403	AUTHENTICATION_ERROR	Your credentials are invalid. See Authentication for more info.
404	NOT_FOUND_ERROR	The requested URI was not found. Check the request and try again.
429	RATE_LIMIT_ERROR	You have exceeded the allowed number of requests. See Rate Limiting for more info.
500	SERVER_ERROR	An unexpected error occurred on the server. Please try again later.