SMS message reports give you delivery statistics, engagement metrics, and recipient-level detail for each message you send. Reports are available for both SMS/MMS and RCS messages.Documentation Index
Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
Use this file to discover all available pages before exploring further.
Metrics reference
Message-level metrics
| Metric | Definition |
|---|---|
| Sent | The number of messages sent from OneSignal, including both those successfully sent to the carrier and failures. |
| Audience | The number of subscriptions in the targeted segment(s). |
| Remaining | The number of subscriptions in the target audience that haven’t yet received the message (queued or in flight). Appears on the dashboard delivery report. |
| Delivered | The number of messages successfully delivered to the carrier. Shown separately for SMS/MMS and RCS in the report. |
| Failed | The number of messages that failed to be sent to the carrier. |
| Suppressed | The number of messages not sent because the subscription has opted out of receiving messages from the sender. |
| Rejected | The number of messages not delivered by the carrier due to number blockage, velocity blockage, or a recipient block list. This is a derived metric: the sum of Provider Errored and Provider Undelivered. |
| Provider Errored | The number of subscriptions for which the carrier failed to send the message. |
| Provider Undelivered | The number of subscriptions for which the carrier sent the message but failed to deliver it. |
| Read (RCS only) | The number of subscriptions who read an RCS message. Available because RCS supports read receipts. |
| Total Clicks | The total number of times a link in the message was clicked, including repeat clicks. |
| Unique Clicks | The number of unique link clicks. Counted once per subscription. |
| Replied | The number of inbound replies that matched a custom keyword. Excludes consent keywords (STOP, HELP, START). |
| Unsubscribed | The number of inbound opt-out keyword replies received (e.g., STOP). |
Report-level metrics
| Metric | Description |
|---|---|
| Delivery rate | The percentage of messages successfully delivered. |
| Failure & rejection rate | The percentage of messages not delivered or suppressed. |
| Click-through rate (CTR) | The percentage of total recipients who clicked a link in this message. See Links for more on click tracking. |
Data retention
SMS messages and related report data are retained for approximately 30 days. Export message or audience data if you need long-term records. See Exporting data.Conversions
Coming soon: Conversion metrics on message reports. Once available, you will see attributed and influenced conversions for each message directly in its report.
Understanding SMS failures
When troubleshooting deliverability, look at the exact error text in Audience Activity.| Error text | Error code | What it usually means | What to do |
|---|---|---|---|
| Message blocked | 30004 | The carrier or a policy layer blocked the message. Common causes: carrier content filtering, sender reputation, 10DLC/registration issues, recipient opt-out state, or regional rules (e.g., India DLT). | Confirm opt-in and STOP handling. Align content with your registered use case. Complete 10DLC/brand registration where required. Avoid spam-like patterns. |
| Unknown destination handset | 30005 | The number is unknown, invalid, or no longer active (wrong digits, disconnected line, or mistyped country code). | Validate and normalize numbers to E.164 before sending. Remove landlines and invalid numbers. See Audience validation. |
| Unreachable destination handset | 30003 | The number may be valid but the handset is off, out of coverage, or roaming in a way that blocks SMS. | Retry later. |
Messages with no error text
Some failures return no error text or an empty reason field when the carrier or provider does not supply a detailed code. In the dashboard, these often roll up under Failed to Send. Recommended steps:- Confirm the number is valid E.164 and the subscription is SMS-eligible and not opted out.
- Retry after a delay in case of transient provider or carrier issues.
- If the issue is widespread, collect example message or delivery SIDs and contact OneSignal support.
Billing
OneSignal SMS customers
View your usage under Settings > Usage > SMS > See breakdown. The breakdown shows segments (not messages) sent by message type, filterable by country. The breakdown is updated daily. The count includes all outbound segments, including auto-replies sent in response to consent keywords (STOP, HELP, START) or other custom keyword replies. Failed messages are not included in the segment count.Twilio integration customers
You pay Twilio directly. For billing questions, see your Twilio dashboard.FAQ
Why does my delivery rate show lower than expected?
Common causes include invalid phone numbers, opted-out subscribers (showing as Suppressed), carrier-side content filtering, or registration issues (showing as Rejected or Provider Errored). Check the error text in Audience Activity for the specific cause.What’s the difference between Failed and Rejected?
Failed means OneSignal could not send the message to the carrier at all. Rejected means the carrier received the message but did not deliver it, typically due to number blockage, velocity limits, or the recipient being on a block list.How long are message reports available?
SMS message reports and audience activity data are retained for approximately 30 days. Export your data if you need longer retention.Can I see which individual subscribers received a message?
Yes. The Audience Activity section of each message report shows recipient-level delivery and engagement details, including any error codes for failed messages.Why do some messages have no error code?
Some carriers and providers do not return detailed error codes for failed deliveries. These show up as empty in Audience Activity. If you see widespread failures with no error detail, collect the message SIDs and contact OneSignal support.Related pages
Composing messages
Encoding, segment math, MMS limits, and how content affects billing.
SMS opt-in and collection
Audience validation and phone number format requirements.
Exporting data
Export delivery and engagement data for long-term retention.
Links
How OneSignal tracks clicks in SMS, MMS, and RCS messages.