Developer Documentation
Consistent Error Codes for Faster Debugging
Recommended error envelope:
{
"success": false,
"error": {
"code": "A21-2005",
"message": "Template requires 3 variables, but 2 were provided."
}
}{
"success": false,
"error": {
"code": "A21-2005",
"message": "Template requires 3 variables, but 2 were provided."
}
}Initial Error Catalogue
| Code | Meaning | Recommended Developer Action |
|---|---|---|
| A21-1001 | Invalid API key | Verify key/environment and authorization header |
| A21-1002 | IP not allowed | Update allowed IP or send from authorized server |
| A21-1003 | Rate limit exceeded | Back off and respect rate-limit headers |
| A21-2001 | Invalid destination number | Correct recipient format |
| A21-2002 | Template not found/inactive | Use an active authorized template |
| A21-2003 | Sender/header not approved | Complete sender mapping/approval |
| A21-2004 | DLT/template validation failed | Review approved content/mapping |
| A21-2005 | Variable mismatch | Send correct count/order of variables |
| A21-3001 | Insufficient balance/entitlement | Recharge or contact billing/support |
| A21-3201 | Route/provider unavailable | Retry according to documented guidance |
| A21-3202 | Message rejected | Inspect rejection category and correct request |
| A21-5000 | Internal error | Retry only if safe; contact support with request ID |
EVERY ALERT. ONE API.
Turn your next business event into a traceable alert.
Start with DLT-ready SMS today on Alert21’s developer-first communication platform.