---
title: "Export subscriptions CSV"
method: POST
path: "/players/csv_export"
---

# Export subscriptions CSV

`POST /players/csv_export`

Generate a GZip-compressed CSV export of your current subscription data using this API endpoint.

## Query parameters

- `app_id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `extra_fields` string[] — Additional properties that you can include in the CSV.
  - `last_active_since` string — A Unix timestamp (in seconds) used to filter Subscriptions based on recent activity. Only Subscriptions with a `last_session` timestamp after this value will be included in the export. Example: To export Subscriptions active since January 1st, 2024, use `1704067200`.
  - `segment_name` string — The name of a specific segment to filter the export. Only subscriptions that belong to this segment will be included in the CSV. Omit this field to export all subscriptions in the app.
  - `include_unsubscribed` boolean — When used with `segment_name`, set to `true` to include unsubscribed subscriptions in the export. By default, segment-filtered exports only return subscribed subscriptions. This parameter has no effect when `segment_name` is not provided.

## Response `200`

200

- object
  - `csv_file_url` string — The URL to download the CSV file. The file is available for 3 days after generation.

## Other responses

- `400` — 400
- `429` — Rate limit exceeded. Wait the number of seconds in the `Retry-After` header before retrying.
- `503` — Service temporarily unavailable. Retry after a short backoff. The body may be empty or non-JSON in some failure modes.

---

[API](https://skmtc.net/onesignal/apis/api-onesignal-com.md) · [All operations](https://skmtc.net/onesignal/apis/api-onesignal-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onesignal/api-onesignal-com/versions/0fc223f7e338/schema)