The following response codes can be returned by the API:
Status Code | Reason phrase | Description |
---|---|---|
200 | Success | Request processed successfully. |
400 | Bad Request | Request failed due to malformed syntax. |
401 | Unauthorized | Auth-Token provided is incorrect. |
403 | Forbidden | Request is not authorized to use this service. |
404 | Not Found | Request is not found. |
406 | Not Acceptable | Request is not in an acceptable format. |
408 | Request Timeout | Response was not returned within the timeout allowance. |
415 | Unsupported Media Type | Request is not using a Media type that is recognized by the server. |
429 | Too many requests | Too many requests were sent. To protect all customers, your account has been temporarily throttled. Check our rate limiting for more details. |
500 | Internal Server Error | The server has encountered an error. |
503 | Service Unavailable | Service unavailable. Check service status for up-to-date information. |
Successful API request returns the response within a result
object. However, should an error occur, an error
object is returned instead with the below fields.
Name | Type | Description |
---|---|---|
type | string | A link to documentation that provides more details about the error you've encountered. |
title | string | The title of the error. |
detail | string | A description of the error. |
instance | string | The endpoint that returned the error. |