Skip to main content

Error Format

Error Codes

400 Bad Request

Code: validation_error or invalid_json Request failed validation. Check the details array for specifics.
Field Error Codes: Common causes:
  • Missing required fields (provider, model, usage, context.billable_customer_id)
  • Invalid enum values for provider
  • Request body isn’t valid JSON

401 Unauthorized

Code: unauthorized API key is missing or invalid.
Check:
  • X-Api-Key header is present
  • Key is correct and active in your dashboard

207 Multi-Status

Some transactions succeeded, some failed. Check results for details.

500 Internal Server Error

Code: internal_error Server-side issue. Safe to retry.