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 keyinvalid_request_error · bad parameters or conflictrate_limit_error · too many requestsapi_error · unexpected server failure