Skip to main content
An example error object returned in a response body looks like this:
Each error object includes a machine-readable code field, the stable identifier you match on programmatically, distinct from the human-readable title and detail. Other potential error codes that may be returned are:

401 Unauthorized

403 Forbidden

502 Bad Gateway

The 401 Unauthorized and 403 Forbidden errors above indicate a problem with your request, so fix the request before you send it again. A 502 Bad Gateway error (code bad_gateway) is different: it means an upstream service the API depends on failed to respond. This is a transient condition, so retry the request after a short delay. In all cases the response will be a JSON object with a single key errors which will be an array of error objects. For more information, check out the responses in the API reference.
Last modified on September 4, 2026