Errors
Responses from the API use HTTP response codes to indicate overview classes of success and error. Error responses contain more detail about the error in the response body, in the error_code
and error_message
properties.
Here is an example error response body for a requesting a non-existent resource:
{
"status_code": 404,
"endpoint": "/v1/record/123",
"error_code": "record_not_exists",
"error_message": "Record does not exist(123)!"
}
Status | error_code | Description |
---|---|---|
400 | invalid_json | The request body could not be decoded as JSON. |
400 | invalid_request_url | The request URL is not valid. |
400 | invalid_request | This request is not supported. |
400 | validation_error | The request body does not match the schema for the expected parameters. Check the "message" property for more details. |
401 | unauthorized | The bearer token is not valid. |
403 | restricted_resource | Given the bearer token used, the client doesn't have permission to perform this operation. |
404 | not_found | Given the bearer token used, the resource does not exist. This error can also indicate that the resource has not been shared with owner of the bearer token. |
409 | conflict_error | The transaction could not be completed, potentially due to a data collision. Make sure the parameters are up to date and try again. |
429 | too_many_requets | This request exceeds the number of requests allowed. Slow down and try again. More details on rate limits |
500 | internal_server_error | An unexpected error occurred. Reach out to Tape support. |