Skip to main content

Error response format

When an error occurs, data is null and the errors array contains one or more error objects:

Error codes

Retry strategy

For errors with "retryable": true, use exponential backoff:

Validation errors

VALIDATION_ERROR responses include a field property indicating which parameter failed:

Tips

  • Always check errors.length > 0 before accessing data
  • Use meta.request_id when contacting support — it uniquely identifies the request
  • For 429 responses, prefer the retry_after_seconds value over a fixed delay
  • For 503 responses, retry with exponential backoff (1s, 2s, 4s)