The Numeral API returns the following status codes:
| Code | Description |
|---|---|
| 200 - OK | Everything worked as expected. |
| 400 - Bad Request | The request could not be accepted, due to missing or incorrect parameters. |
| 401 - Unauthorized | No valid API key or no API key was provided. |
| 403 - Forbidden | The API key does not have the necessary permissions to perform the request. |
| 404 - Not Found | The requested resource could be not found. |
| 409 - Conflict | The request failed due to the current state of the ressource. |
| 415 - Unsupported Media Type | The provided Content-Type header is not supported for a given route. |
| 429 - Too Many Requests | Too many requests were received. We recommend spacing requests increasing the interval between your requests, for instance using an exponential backoff. |
| 500 - Internal Server Error | The Numeral API experienced an internal server error. Our team has been notified and is working to fix it. We recommend retrying the request using an idempotency key to avoid any duplicates. |
| 504 - Gateway Timeout | The Numeral API gateway experienced a timeout. We recommend retrying the request using an idempotency key to avoid any duplicates. |