Export Message Data
How to download your message data from the dashboard and API
Message Data Limitations
Messages sent through the OneSignal API and Automated Messages are only accessible for 30 days from when they were created.
Messages sent through the OneSignal dashboard are accessible for the lifetime of the app.
Message Data can be exported using the OneSignal API or Dashboard.
How to Export Message Data from API
You can download Message Data from the API using the following options. Note that due to the volume of both API and Automated Messages, these are only accessible for 30 days from when they were created.
API Endpoint | Details | Data |
---|---|---|
View Notifications | Provides paginated view of up to 50 messages per request. Can be filtered by notification type. ie API, Dashboard or Automated messages. | Contains notification payload, targeting parameters and delivery stats. |
View Notification | Provides a single message's data. | Similar to View Notifications data. |
Notification History | OneSignal Paid Plan Required Provides list of Subscription IDs that were "sent" or "clicked" a message. | Retrieving "sent" Subscription IDs is only available for messages that had over 1000 recipients.If the message targeted a segment or used filters that were under 1000 recipients, the subscription_ids that were targeted will be unavailableIf the message targeted Subscription IDs (like automated messages) or External IDs, you can access the sent data in the View Notification(s) endpoints."clicked" data is available for all notifications. |
Audience Activity | Generate a compressed CSV report of all of the events data for a notification. | This API provides the same data exportable from within the dashboard Audience Activity section for each message report. For details on each type of data, see: Push Notification Message Reports Email Message Reports SMS Message Reports |
How to Export Message Data from Dashboard
You can download Message Data sent from the OneSignal dashboard. Filters and details of the message available below. Upgraded OneSignal Plan Required.
Note that due to the volume of both API and Automated Messages, these are only accessible for 30 days from when they were created.
You can export the full text, delivery statistics, and send times, of all messages you've sent from the dashboard by going to the Delivery Tab and then clicking Export.
Filters
Filter | Details |
---|---|
Messages | Use to get All Messages, Dashboard, API, Automated, or Test messages. |
Device Type | Filters notifications sent to specific operating system and channels (Web, Android Mobile, iOS Mobile, Email). |
Text Search | Currently only available for Messages sent from Dashboard (must select Messages: Dashboard Messages). |
Start and End Date | Sort by specific dates. |
Search | Apply the selected filters to the search. |
Export | Send an email containing a CSV of the currently displayed message data to your logged in email. Emails to download the export typically arrive within a few minutes, but may take up to 30 minutes as delivery statistics propagate. The CSV will contain up to 1,000,000 rows. If you want to export more than 1,000,000 notifications, just apply a date range or filters to get the export size below 1,000,000 rows. The file will be zipped. |
Clear | Removes the currently selected filter data. |
Exported Data Attributes
Property | Description |
---|---|
id | The OneSignal Notification ID. |
name | The name you gave the message. |
completed_at | When the Notification finished sending in UTC format. |
total_queued | How many subscriptions were in the targeting parameters at the time of sending. |
successful | How many messages were delivered to Google and Apple's servers. |
failed | How many messages were sent to unsubscribed devices. See What are Failed Notifications for details. |
errored | How many error users were reported, check your OneSignal dashboard settings for more details. |
remaining | How many messages are left to be sent. |
received | How many devices received the message. See Confirmed Deliveries. |
converted | How many messages were clicked. |
contents | The Notification Message body. |
headings | The Notification Title. |
queued_at | When the message was created in UTC format. |
send_after | When the Notification was set to start sending to subscribers. |
url | The Launch URL set. |
data | Any custom data set in the notification. |
contents_en , headings_en , etc | Contents and headings based on language translations provided. |
delayed_option | If timezone or intelligent delivery was used. |
delivery_time_of_day | If timezone was used, the timezone to deliver. |
global_image | Global Image URL used. |
included_segments , excluded_segments, filters | Segments included or excluded if provided. Otherwise, filters used. |
isIos , isAndroid , isHuawei , isSMS , isWeb , isEmail | Platforms enabled (t) or disabled (f). |
throttle_rate_per_minute | Throttle rate set. |
frequency_capped , frequency_capped_status | Number capped and if capping was enabled. |
Channel Specific Attributes
Channel | Attribute | Description |
---|---|---|
email_subject | The subject of the email. | |
email_from_name | The senders name. | |
email_from_address | The senders email. | |
isEmail | Boolean - indicates if message was an Email message. | |
SMS | sms_from | Sender of the SMS. |
sms_media_urls | ||
isSMS | Boolean - indicates if message was an SMS message. | |
Huwaei | huawei_sound huawei_led_color huawei_accent_color huawei_channel_color huawei_visibility huawei_channel_id huawei_small_icon huawei_large_icon huawei_big_picture huawei_msg_type | Specific Attributes for message sends to Huawei devices. |
iOS | ios_attachments | An object of the iOS attachment. |
Android | android | |
Live Activities | live_activity_activity_id | These identifiers should be unique to each Live Activity. |
live_activity_ios_event_updates | Data payload for Live Activity updates. | |
live_activity_ios_event_kind | Specifies if an event is an update or end of a Live Activity. | |
live_activity_ios_dismiss_at | The time that the Live Activity will disappear from the lock screen. | |
live_activity_ios_stale_date | The time that the system considers the Live Activity outdated and changes Activity State to ActivityState.stale. | |
Amazon Fire | amazon_fire | |
Chrome Browser Extensions | chrome_extension | |
Windows Phone 8.0 | windows_phone_legacy |
Platform Statistics
Platform statistics enable you to see how a platform is performing.
Channel | Data Attribute | Details |
---|---|---|
Web Push | edge_web_push | How well users have interacted with web push on Edge Browsers. |
chrome_web_push | How well users have interacted with web push on Chrome Browsers. | |
firefox_web_push | How well users have interacted with web push on Firefox Browsers. | |
safari_web_push | How well users have interacted with web push on Safari Browsers. | |
Mobile Push | ios | How well users have interacted on iOS devices. |
android | How well users have interacted on Android devices. | |
successful email_successful | How many emails were accepted by the Email Service Provider. | |
email_delivered | The email was received by the Inbox Service Provider and should show in the user's inbox. | |
failed | ||
errored | ||
converted | ||
received | How many were accepted by the recipient email server. | |
frequency_capped | ||
opened | The number of times an email has been opened. This can include the recipient opening the email multiple times. | |
unique_opens | The number of unique recipients who have opened your email. | |
clicks | The total number of clicked links from your email. This can include the recipient clicking email links multiple times. | |
unique_clicks | The number of unique clicks that your recipients have made on your email. | |
bounced | The number of hard or soft bounces for this email. Emails that soft bounce will be retried several times before they are either successfully delivered or registered as a hard bounce. | |
reported_spam | The number of recipients who reported this email as spam. | |
unsubscribed | The number of recipients who opted out of your emails using the unsubscribe link in this email. |
Updated 5 days ago