Error Codes

API & Delivery Error Codes

HTTP API Error Codes

• 400 — Bad Request — Missing or invalid parameters
• 401 — Unauthorized — Invalid or missing API key
• 403 — Forbidden — Insufficient permissions for this action
• 404 — Not Found — Resource does not exist
• 429 — Too Many Requests — Rate limit exceeded
• 500 — Internal Server Error — Contact support if this persists

Delivery Status Codes

• DELIVRD — Message delivered successfully
• UNDELIV — Undeliverable — number may be invalid or unreachable
• EXPIRED — Message expired in queue before delivery
• REJECTD — Rejected by carrier — may indicate content filtering
• UNKNOWN — Delivery status unknown — may still be in transit
• DELETED — Message was deleted before delivery

Common Error Codes

• ERR_001 — Invalid destination number format
• ERR_002 — Sender ID not allowed for this destination
• ERR_003 — Message content exceeds maximum length
• ERR_004 — Account credit insufficient
• ERR_005 — Destination country not enabled on your account
• ERR_006 — Rate limit exceeded — reduce submission rate