# HTTP status codes

We return the following HTTP status codes from our endpoints.

## Success status codes (2xx)

| HTTP status code | Status message | Purpose |
|  --- | --- | --- |
| [200](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200) | `OK` | The call has been completed. |
| [201](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/201) | `Created` | The new resource has been fully created. |
| [202](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/202) | `Accepted` | The request processing has been started succesfully but will be completed asynchronously. |
| [204](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/204) | `No Content` | The resource has been succesfully deleted. |


## Client error status codes (4xx)

| HTTP status code | Status message | Purpose |
|  --- | --- | --- |
| [400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400) | `Bad Request` | The incoming request was malformed. |
| [401](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401) | `Unauthorized` | The caller could not be authenticated. |
| [403](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/403) | `Forbidden` | The caller is not allowed to take this action. |
| [404](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404) | `Not Found` | The specified resource was not found. |
| [405](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/405) | `Method Not Allowed` | The requested HTTP method is not allowed on this resource. |
| [406](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/406) | `Not Acceptable` | The resource does not have a current representation that would be acceptable to the user agent. The "Accept" header defined an unsupported value. |
| [426](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/426) | `Upgrade Required` | The request was made for an older version of the API, after it has been retired. |
| [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) | `Too Many Requests` | The caller was throttled due to exceeding the call quota. |


## Server error status codes (5xx)

| HTTP status code | Status message | Purpose |
|  --- | --- | --- |
| [500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) | `Internal Server Error` | Something unexpectedly went wrong with the service. Please reach out to our support. |
| [503](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/503) | `Service Unavailable` | An internal service could not be reached. Please try again. |