---
schema_version: "1"
id: 38eda0d5e86741d6d1c0d173765bd2c709bd8da1629c416994a537414c27f36c
title: SMS Status Codes
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/sms-status-codes.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/sms-status-codes.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: acd0a343255d6b52f95513a6d97e47dbc986621ebc6ec0ee76787f8372f7e6ea
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# SMS Status Codes

This table includes status codes returned from MobileConnect API calls for all locations. Use these codes to evaluate and troubleshoot your SMS sends.

| Code | Status                                             | Definition                                                                                                                                                                                                                                                                                                                                          |
| ---- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1000 | `QueuedToSfmcSendService`                          | The message was added to the Marketing Cloud Engagement message sending service queue.                                                                                                                                                                                                                                                              |
| 1500 | `QueueFailureToSfmcSendService`                    | A failure occurred when attempting to add the message sending service queue. You can try to send the message again later.                                                                                                                                                                                                                           |
| 1501 | `ValidationError`                                  | A validation error occurred. You can try to send the message again later.                                                                                                                                                                                                                                                                           |
| 2000 | `DeliveredToAggregator`                            | The message was delivered from Marketing Cloud Engagement to a downstream delivery partner (aggregator). This status doesn’t necessarily indicate that the message was delivered to the recipient. The status is updated when we receive a delivery confirmation from the mobile carrier or device. For shared codes, this status is the final one. |
| 2500 | `FailedToAggregator`                               | An error occurred when sending the message from Marketing Cloud Engagement to the downstream aggregator. You can try to send the message again later.                                                                                                                                                                                               |
| 2501 | `UnknownToAggregator`                              | The downstream aggregator experienced an error while processing the message.                                                                                                                                                                                                                                                                        |
| 2502 | `FailedToAggregatorDueToInvalidDestinationAddress` | The downstream aggregator couldn’t deliver the message because the destination phone number invalid.                                                                                                                                                                                                                                                |
| 2600 | `ThrottledToAggregator`                            | The downstream aggregator couldn’t accept the message because too many requests were received simultaneously. Marketing Cloud Engagement automatically attempts to re-send messages that were throttled in this way. If you see this status in your logs, it means that our attempts to re-send the message were unsuccessful.                      |
| 2601 | `SocketExceptionToAggregator`                      | The downstream aggregator couldn’t accept the message because of a connection error. Marketing Cloud Engagement automatically attempts to re-send messages that fail in this way. If you see this status in your logs, it means that our attempts to re-send the message were unsuccessful.                                                         |
| 3000 | `Enroute`                                          | The message is in the process of being delivered to the recipient’s mobile carrier.                                                                                                                                                                                                                                                                 |
| 3001 | `SentToCarrier`                                    | The message was sent to the recipient’s mobile carrier but hasn’t been accepted yet.                                                                                                                                                                                                                                                                |
| 3002 | `AcceptedByCarrier`                                | The message was accepted by the recipient’s mobile carrier but hasn’t been delivered yet.                                                                                                                                                                                                                                                           |
| 3400 | `Unknown`                                          | An unknown error occurred.                                                                                                                                                                                                                                                                                                                          |
| 4000 | `Delivered`                                        | The message was delivered to the recipient’s device.                                                                                                                                                                                                                                                                                                |
| 4500 | `Undeliverable`                                    | The message wasn’t delivered to the recipient’s device.                                                                                                                                                                                                                                                                                             |
| 4501 | `Expired`                                          | The message wasn’t delivered and has exceeded the maximum delivery time. This issue can occur when the recipient’s device isn’t connected to a mobile network or is otherwise unreachable.                                                                                                                                                          |
| 4502 | `Deleted`                                          | The message wasn’t delivered and has been deleted by the carrier.                                                                                                                                                                                                                                                                                   |
| 4503 | `Rejected`                                         | The message was rejected by the recipient’s mobile carrier. This issue can occur when the carrier determines that the message is spam or other abusive content.                                                                                                                                                                                     |
| 4504 | `FailedDueToUnknownSubscriber`                     | The message wasn’t delivered because the carrier couldn’t find the subscriber.                                                                                                                                                                                                                                                                      |
| 4505 | `FailedDueToInvalidDestinationAddress`             | The message wasn’t delivered because the destination phone number was invalid.                                                                                                                                                                                                                                                                      |