Skip to main content

​
Error Codes

For the full error-code reference — every code the platform emits, grouped by domain — see the Error Code Reference page. The table below is a focused subset of the codes developers encounter most during integration.

​
Common Error Codes

CodeHTTPDescription
UNAUTHORIZEDvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
INVALID_API_KEYvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
INSUFFICIENT_PERMISSIONSvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
VALIDATION_ERRORvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
INVALID_PHONE_NUMBERvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
NOT_FOUNDvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
RATE_LIMIT_EXCEEDEDvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
MESSAGE_SEND_FAILEDvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
INSUFFICIENT_BALANCEvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
INTERNAL_ERRORvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.
SERVICE_UNAVAILABLEvariesPlatform-defined error code. See source comment in packages/shared/src/errors.ts for context.

​
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://docs.orbit.devotel.io/errors/INVALID_PHONE_NUMBER"
  }
}
For the complete list of error codes — including messaging, voice, AI-agent, billing, compliance, and system errors — see the Error Code Reference.