Common errors you may run into and what they mean
Our APIs use conventional HTTP response status codes to indicate the success or failure of a request. A 200 means that an API returned a matching record, and a 404 means that an API neither found nor returned a matching record. Any 4xx code besides a 404 indicates that there was an issue with the request, and 5xx codes indicate that an internal issue with the API occurred.
When an API call fails (does not return 200 response code), it will return an error response to help debug what went wrong with the request. The error response will be a JSON object with the following fields:
| FIELD NAME | TYPE | DESCRIPTION |
|---|---|---|
| status | Integer | The HTTP response status code. |
| error | Object | The object containing the error type and message. See error codes below for examples. |
| error.type | String | The error type. |
| error.message | String | The error message. |
{ "status": 404, "error": { "type": "not_found", "message": "No records were found matching your request" } }
{ "status": 429, "error": { "type": "rate_limit_error", "message": "An error occurred due to requests hitting the API too quick" } }
| STATUS | ERROR NAME | DESCRIPTION |
|---|---|---|
| 400 | invalid_request_error | The request contained either missing or invalid parameters. |
| 401 | authentication_error | The request contained a missing or invalid key. |
| 402 | payment_required | You have reached your account maximum (all matches have been used). |
| 404 | not_found | There were no records found matching your request. |
| 405 | invalid_request_error | You cannot use the request method on the requested resource. |
| 429 | rate_limit_error | An error occurred due to requests hitting the API too quick. |
| 5xx | api_error | The server encountered an unexpected condition that prevented it from fulfilling the request. |
Cookie Notice
We and third parties such as our customers, partners, and service providers use cookies and similar technologies (\"cookies\") to provide and secure our Services, to understand and improve their performance, and to serve relevant information. For more information, see our Cookie Policy.