---
title: "Export Subscriptions"
method: GET
path: "/v1/shops/{shopId}/subscriptions/export"
tags: ["Subscriptions"]
---

# Export Subscriptions

`GET /v1/shops/{shopId}/subscriptions/export`

## Request

- Base URL: `https://api.sellauth.com`
- URL: `https://api.sellauth.com/v1/shops/{shopId}/subscriptions/export`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sellauth/apis/sellauth-api/docs/v1/shops/:shopId/subscriptions/export/get.ts> (a function with typed inputs; its response is checked against the schema)

Exports the filtered subscriptions as a CSV file.

## Request body

- object
  - `page` integer, nullable: Page number. Must be at least 1.
  - `perPage` integer, nullable: Items per page, 1-100. Must be at least 1. Must not be greater than 100.
  - `orderColumn` 'id' | 'created_at' | 'current_period_end' | 'recurring_price_usd' | 'cycles_completed', nullable
  - `orderDirection` 'asc' | 'desc', nullable
  - `id` integer, nullable: Filter by subscription ID.
  - `status` 'pending' | 'trialing' | 'active' | 'past_due' | 'cancelled' | 'expired', nullable: Deprecated. Use statuses.
  - `statuses` string[]
  - `email` string, nullable: Filter by customer email.
  - `customer_id` integer, nullable: Filter by customer ID.
  - `product_id` integer, nullable: Filter by product ID.
  - `variant_id` integer, nullable: Filter by variant ID.
  - `product_name` string, nullable: Filter by product name.
  - `variant_name` string, nullable: Filter by variant name.
  - `gateways` object, nullable: Filter by payment gateways.
  - `payment_method_ids` object, nullable: Filter by payment method IDs.
  - `intervals` string[]
  - `renewal_method` 'auto' | 'manual', nullable: Filter by automatic or manual renewal.
  - `cancel_at_period_end` boolean, nullable: Only subscriptions set to end at the period end.
  - `has_failed_payments` boolean, nullable: Only subscriptions with failed payments.
  - `suspended` boolean, nullable: Only suspended subscriptions.
  - `currency` string, nullable: Must be 3 characters.
  - `external_id` string, nullable: Filter by the gateway subscription ID.
  - `created_at_start` string, nullable: Must be a valid date.
  - `created_at_end` string, nullable: Must be a valid date. Must be a date after <code>created_at_start</code>.
  - `current_period_end_start` string, nullable: Must be a valid date.
  - `current_period_end_end` string, nullable: Must be a valid date. Must be a date after <code>current_period_end_start</code>.
  - `cancelled_at_start` string, nullable: Must be a valid date.
  - `cancelled_at_end` string, nullable: Must be a valid date. Must be a date after <code>cancelled_at_start</code>.

## Response `200`

## Changes

- **2026-11-02** `ff0d59c98d7a`: 2 breaking, 36 info
  - request property `intervals/items/` was restricted to a list of enum values
  - request property `statuses/items/` was restricted to a list of enum values
  - the request property `cancel_at_period_end` became nullable
  - the request property `cancelled_at_end` became nullable
  - …34 more
- **2026-10-13** `5cbdf10d05ab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/subscriptions/export/get.md)

---

[API](https://skmtc.dev/sellauth/apis/sellauth-api.md) - [All operations](https://skmtc.dev/sellauth/apis/sellauth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sellauth/apis/sellauth-api/revisions/ff0d59c98d7a?raw)