Generate a GZip-compressed CSV export of your current subscription data using this API endpoint.
segment_name
: Only export Subscriptions from a specific segment.last_active_since
: Export Subscriptions where their last_session
was after a specific Unix timestamp. Example: Use 1704067200
for Subscriptions active since January 1st, 2024.csv_file_url
may return a 404 until generation completes.csv_file_url
until the file becomes available. Implement retry logic based on expected data volume and generation speed.Only one export is allowed at a time per account. Wait until the .csv.gz
file is downloaded before triggering another export.extra_fields
parameter.id
: The Subscription ID.identifier
: The push token, email address, or phone number depending on the Subscription type.session_count
: The number of times the user has opened the app.language
: The user’s language in ISO 639-1 format.timezone
: Deprecated — use timezone_id
instead.game_version
: The version of your app that the user is currently using.device_os
: The device’s operating system version.device_type
: Integer representing channel/device type.
0
: iOSPush1
: AndroidPush2
: FireOSPush5
: ChromePush7,17
: SafariPush11
: Email14
: SMSdevice_model
: The device’s hardware string.ad_id
: Deprecated.tags
: Custom key/value data.last_active
: The last time the user was active.playtime
: The total amount of time in seconds the user had the mobile app open.amount_spent
: The total amount the user spent on consumable in-app purchases.created_at
: The first time the user was seen.invalid_identifier
: Boolean flag for unsubscribed state.
t
: Unsubscribedf
: Subscribedextra_fields
)extra_fields
in your request to include any of the following:
external_user_id
: Maps to the external_id
of the user.onesignal_id
: OneSignal’s user ID.location
: Adds the lat
and long
coordinates if set.country
: The user’s country in ISO 3166-1 Alpha 2 format.rooted
: Only available to OneSignal SDKs. Indicates if the Android device is rooted or jail-broken.ip
: The IP address if detected. Can be IPv4 or IPv6 format.web_auth
: Only available to OneSignal SDKs. The web_auth
key for web push.web_p256
: Only available to OneSignal SDKs. The web_p256
for web push.unsubscribed_at
: The date and time the user last unsubscribed. They may resubscribe at any time. Check the invalid_identifier
field to determine if they are currently subscribed.notification_types
: Indicates the reason for the subscription status. Values are updated automatically as events are detected by our frontend SDKs but you should set this manually when updating via our REST API. 1
is subscribed and -31
is reserved for unsubscribed via the API. See Subscriptions.timezone_id
: The user’s timezone in IANA format.Your App API key with prefix Key
. See Keys & IDs.
Your OneSignal App ID in UUID v4 format. See Keys & IDs.
200
The response is of type object
.