Skip to main content
API error responses share the same JSON format. Use the HTTP status code to identify the type of failure.
  • message: A human-readable explanation of the error. The text varies by failure; use the HTTP status code for programmatic error handling.
  • documentationUrl: A link to the documentation for the operation you called, or this Errors page when the operation cannot be identified.
Endpoint references show this shared format as the default error response.

Status codes

Retrying failed requests

502 and 504 responses are transient. Retry the request with a short delay between attempts. A 500 response may also be transient, but retrying isn’t guaranteed to succeed. If it persists, contact us. For 429 responses, wait before retrying. See Rate limits for current limits.