Our API uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, validation errors, etc.), and codes in the 5xx range indicate an actual error with our servers.

HTTP Status Code Summary

Status code
200 OK
Everything worked as expected
400 Bad Request
Often missing a required parameter or validation of a supplied parameter has failed
401 Unauthorized
The oauth parameters provided to not have permission for this resource
402 Request Failed
Parameters were valid but request failed
404 Not Found
The requested item does not exist
500, 502, 503, 504 Server errors
Something went wrong on our end

Error/validation responses

Returned as status 400 Bad Request on POST or PUT requests
{"__all__": ["The provided error is related to the object as a whole"]}
{"some_field": ["This field is required"]}
{"nested_field": {"nested_field-1": {"some_field": ["This field is required"]}}}