Documentation

Errors

HTTP status codes and error response shape.

All REST errors use the same JSON envelope:

JSON

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or revoked API key"
  }
}

Status codes

  • 400 · bad_requestInvalid query parameters
  • 401 · unauthorizedMissing or invalid Bearer token
  • 403 · forbiddenPro subscription required
  • 404 · not_foundUnknown route
  • 429 · quota_exceededDaily credit limit reached
  • 500 · internal_errorUnexpected server error