Skip to main content

​
Error Codes

For the full error code reference with resolution guidance, see the Error Code Reference page.

​
Common Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Missing or invalid authentication
INVALID_API_KEY401API key is malformed, revoked, or does not exist
INSUFFICIENT_PERMISSIONS403Authenticated identity lacks the required RBAC role
VALIDATION_ERROR400 / 422One or more request fields failed validation
INVALID_PHONE_NUMBER422Phone number not in valid E.164 format
NOT_FOUND404Resource does not exist
RATE_LIMIT_EXCEEDED429Too many requests in the current window
MESSAGE_SEND_FAILED500Downstream provider rejected the message
INTERNAL_ERROR500Unexpected server error

​
Error Response Format

{
  "error": {
    "code": "INVALID_PHONE_NUMBER",
    "message": "The 'to' field must be a valid E.164 phone number",
    "status": 422,
    "details": { "field": "to", "value": "+1234", "expected": "E.164 format e.g. +14155552671" }
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-08T00:00:00Z",
    "docs_url": "https://orbit-docs.devotel.io/errors/INVALID_PHONE_NUMBER"
  }
}
For the complete list of error codes — including messaging, voice, AI agent, billing, and system errors — see the Error Code Reference.