β External Public API > Error Codes β
Our APIs use HTTP error codes to report errors. If an error occurs, an error code and an error message are also returned in the response body.
Example:
json
{
"date": "Wed May 25 2022 09:20:52 GMT+0000 (Coordinated Universal Time)",
"code": "UNAUTHENTICATED",
"message": "you are not authenticated",
"httpStatusCode": 401
}1
2
3
4
5
6
2
3
4
5
6
| Status code | Error Code (code property) | Error Message (message property) | Description |
|---|---|---|---|
| 200 | OK. The request was successful. | ||
| 201 | Created. The request was successful and a new resource was created. | ||
| 400 | BAD_REQUEST | Bad request. The request was unacceptable, often due to missing a required parameter. See error code below. | |
| 401 | UNAUTHENTICATED | you are not authenticated | Unauthorized. The provided API key is invalid. |
| 403 | Forbidden. The provided API key does not have the required permissions. | ||
| 404 | NOT_FOUND | Resource not found | Not found. The requested resource does not exist. |
| 429 | RATE_LIMIT | Too Many Requests | Too many requests. The rate limit has been exceeded. |
ALREADY_EXISTS | A resource with this id already exists. | ||
| 5xx | Internal server error. |