Delivery error codes
Failed and undelivered messages expose delivery_error_code from this Statxt dictionary. Use it for suppress and retry decisions. Request-level HTTP errors live on API error codes.
error_code on the message object is a deprecated compatibility field and is not part of this catalog.
Delivery catalog
| Code | Suppress | Retryable | Meaning | Docs |
|---|---|---|---|---|
| destination_deactivated | yes | no | The destination number is deactivated, suspended, or cannot receive SMS. | Docs |
| destination_unroutable | yes | no | The destination cannot be routed or is not provisioned for SMS. | Docs |
| destination_blocked | yes | no | The destination is barred or blocked by the operator or subscriber. | Docs |
| destination_unreachable_temp | no | yes | The handset or network was temporarily unreachable. | Docs |
| destination_prepaid_exhausted | no | yes | The recipient prepaid balance could not accept the message. | Docs |
| content_blocked | no | no | The message was blocked as spam, content, or policy — not proof the number is dead. | Docs |
| sender_or_account_issue | no | yes | Delivery failed because of rate limits, session, or sender/account configuration. | Docs |
| carrier_rejected | soft | no | The carrier rejected the destination for an ambiguous reason (deactivated, unable to receive, prepaid, or policy). | Docs |
| delivery_failed | no | no | Delivery failed for an unmapped or unspecified reason. | Docs |