RCS Status & Error Codes
RCS status codes are grouped into categories, each with its own code range, the same way SMS status codes are. "Final" indicates whether the status is the last one you'll see for a message, or whether more updates may follow.
Submitted
The message has been submitted to the operator, or at least partially delivered.
Category: submitted
Code range: 100-199
| code | Reason | Final | Description |
|---|---|---|---|
| 100 | 100-submitted | No | The operator has received your message and sent an acknowledgement, but the recipient has not yet received the message |
Delivered
The message has been delivered to the operator without issue.
Category: delivered
Code range: 200-299
| code | Reason | Final | Description |
|---|---|---|---|
| 200 | 200-delivered | No | Fully delivered |
| 201 | 201-read | Yes | Message was read |
Failed
Denied by the RCS Business Messaging platform for a given reason.
Category: failed
Code range: 300-349
| code | Reason | Final | Description |
|---|---|---|---|
| 346 | 346-unknown-rcs | Yes | Message was delivered but we received an error we do not recognize |
Expired
The message could not be delivered before it expired.
Category: expired
Code range: 350-359
| code | Reason | Final | Description |
|---|---|---|---|
| 351 | 351-expired | Yes | Message has expired before agent delivery |
Blocked
The message could not reach the recipient because your Agent isn't reachable there, or the destination isn't valid.
Category: blocked
Code range: 500-599
| code | Reason | Final | Description |
|---|---|---|---|
| 550 | 550-no-agent | Yes | The message is blocked because the Agent has not launched on the recipient's carrier |
| 551 | 551-rcs-unreachable | Yes | The destination device is not RCS-enabled or was not found |
Fallback
The message was sent through a fallback channel — SMS, by default. See RCS to SMS Fallback.
Category: fallback
Code range: 600-699
| code | Reason | Final | Description |
|---|---|---|---|
| 600 | 600-fallback-sms-incompatible | Yes | Message could not be sent as RCS, sent as SMS instead |
| 601 | 601-fallback-sms-expired | Yes | Message was submitted but expired at the provider's side |
| 602 | 602-fallback-sms-generic | Yes | Message timed out or returned an internal error |
Rejected
Denied by Naxai for a specific reason before it reached the operator.
Category: rejected
Code range: 800-849
| code | Reason | Final | Description |
|---|---|---|---|
| 801 | 801-invalid-number | Yes | Given the destination number is invalid |
| 806 | 806-country-restriction | Yes | Given destination country is not in the allow list |
| 808 | 808-blacklisted | Yes | Given message was blocked or blacklisted |
| 810 | 810-no-carriers | Yes | Given provider for the destination is not yet supported |
| 811 | 811-rcs-missing-features | Yes | Destination device is missing RCS features |
Canceled
Denied by exception, or canceled by the customer.
Category: canceled
Code range: 850-899
| code | Reason | Final | Description |
|---|---|---|---|
| 850 | 850-customer-canceled | Yes | Message has been canceled by the customer prior to submission to the operator |
| 851 | 851-system-canceled | Yes | Message has been canceled on our end for any given reason |
| 852 | 852-system-failure | Yes | The platform could not send the message due to unforeseen circumstances |
| 854 | 854-system-expired | Yes | Message has expired before being submitted to the operator |
What's next
Updated 27 days ago