All errors are returned as JSON with an HTTP status code and an error message field.
Standard Error Codes
| HTTP Code | Error Message | Description |
|---|
400 | Varies by endpoint | Invalid or missing required field |
401 | Invalid API credentials | x-api-key or x-api-secret is incorrect |
403 | Unauthorized account access | x-account-id does not match the authenticated account |
429 | Rate limit exceeded. Try again later. | More than 100 requests per minute |
500 | Internal server error | Unexpected server-side issue |
Example Error Response
{
"error": "Either email or phoneNo is required"
}
Always check for a 400 status first — most integration issues stem from missing or malformed request fields.
