Error Format
Error Codes
400 Bad Request
Code: validation_error or invalid_json
Request failed validation. Check the details array for specifics.
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.
X-Api-Keyheader 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.