Exporting data

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.

​

Overview

You can export data from OneSignal using any of the following methods:

• Dashboard CSV exports — Download Subscriptions and Sent Messages as CSVs from the Audience and Delivery pages.
• REST API endpoints — Export Subscription data, message reports, and per-user audience activity programmatically.
• Event Streams — Stream message events to your own destination in real time.
• Integrations — Forward data to third-party tools like Segment, Mixpanel, and Amplitude.

​

Data retention

• User and Subscription data:
  • Paid plans: Available for the lifetime of the app.
  • Free plans: Automatically deleted after 18 months of inactivity.
• Dashboard-sent messages: Available for the lifetime of the app.
• API-sent messages: Available for approximately 30 days from when they were sent.
• Audience activity: Available for approximately 30 days from when the related message was sent.
• Journey-sent messages: Downloadable from the dashboard. See Journey analytics.

---

​

Export message data

To stream real-time message events to your own destination, use Event Streams.

---

​

Export subscription data

OneSignal exports Subscription records (push tokens, email addresses, and phone numbers), not Users. A user without any attached Subscription will not appear in these exports. To retrieve individual users, use the View user API. See Users and Subscriptions for the distinction.