Errors

Errors return a consistent JSON body with a type, human-readable message, and optional details for validation failures.

Error shape
{
  "error": {
    "type": "invalid_request_error",
    "message": "Request validation failed.",
    "details": [
      { "path": "amount", "message": "Expected number, received string" }
    ]
  }
}

Error types

authentication_error · invalid or missing API key
invalid_request_error · bad parameters or conflict
rate_limit_error · too many requests
api_error · unexpected server failure