---
title: "Get Export"
method: GET
path: "/v1/exports/{id}"
tags: ["Exports"]
---

# Get Export

`GET /v1/exports/{id}`

Retrieves the details of an existing export, including its current `status`. Supply the unique export ID returned when the export was created.

## Path parameters

- `id` string, required

## Response `200`

An envelope wrapping a single export object.

- ExportBodyForExport — An envelope wrapping a single export object.
  - `export` Export, required — An Export represents an asynchronous request to generate a CSV file of your data, such as payments, subscriptions, customers, or reconciliation records. Create one to start the job, poll it until its `status` is `completed`, then request a presigned URL to download the file.
    - `export_id` string, required — Unique identifier for the export.
    - `description` string, nullable — An arbitrary description you can attach to the export for your own reference.
    - `type` 'product' | 'payment' | 'subscription' | 'customer' | 'checkout_session' | 'charge_reconciliation' | 'payout' | 'line_item' | 'line_item_revenue' | 'dispute', required — The type of records the export contains.
    - `status` 'created' | 'started' | 'cancelled' | 'failed' | 'processing' | 'completed', required — The processing status of the export.
    - `created_at` string, required — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
    - `started_at` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
    - `completed_at` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
    - `metadata` object, nullable — Set of key-value pairs you can attach to the export for storing additional structured information.
    - `filters` Filters — Criteria that restrict which records an export includes. The filter variant must match the export's `type` (e.g. a `payment` export takes the `payment` filter); the unused criteria are ignored. When no filter is supplied, the export includes all of your records.
      - `payment` object — Filters a `payment` export.
        - `limit` integer, nullable — Accepted but not currently applied to the export.
        - `status` 'canceled' | 'processing' | 'requires_action' | 'requires_capture' | 'requires_confirmation' | 'requires_payment_method' | 'succeeded' — The current lifecycle status of the payment intent.
        - `starting_after` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `ending_before` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `customer` string, nullable — Accepted but not currently applied to the export.
      - `checkout_session` object — Filters a `checkout_session` export.
        - `limit` integer, nullable — Accepted but not currently applied to the export.
        - `offset` integer, nullable — Accepted but not currently applied to the export.
        - `payment_intent` string, nullable — Accepted but not currently applied to the export.
        - `client_reference_id` string, nullable — Accepted but not currently applied to the export.
        - `start_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `end_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `subscription` object — Filters a `subscription` export.
        - `limit` integer, nullable — Accepted but not currently applied to the export.
        - `offset` integer, nullable — Accepted but not currently applied to the export.
        - `starting_after` string, nullable — Accepted but not currently applied to the export.
        - `ending_before` string, nullable — Accepted but not currently applied to the export.
        - `start_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `end_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `customer` PaginationFilter — Date-range bounds applied when generating customer and product exports.
        - `limit` integer, nullable — Accepted but not currently applied; the export includes all records within the date range.
        - `offset` integer, nullable — Accepted but not currently applied; the export includes all records within the date range.
        - `starting_after` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `ending_before` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `product` PaginationFilter — Date-range bounds applied when generating customer and product exports.
        - `limit` integer, nullable — Accepted but not currently applied; the export includes all records within the date range.
        - `offset` integer, nullable — Accepted but not currently applied; the export includes all records within the date range.
        - `starting_after` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `ending_before` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `charge_reconciliation` object — Filters a `charge_reconciliation` export.
        - `start_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `end_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `payout` object — Filters a `payout` export.
        - `start_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `end_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `dispute` object — Filters a `dispute` export by dispute (chargeback) open date.
        - `start_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `end_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `line_item` object — Filters a `line_item` export.
        - `start_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `end_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
      - `line_item_revenue` object — Filters a `line_item_revenue` export.
        - `start_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
        - `end_date` string — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
    - `test_mode` boolean, required — Whether the export was created in test mode. `true` for test-mode exports, `false` for live-mode exports.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

[API](https://skmtc.dev/withflex/apis/flex-api.md) · [All operations](https://skmtc.dev/withflex/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withflex/flex-api/revisions/b1560fc2f199/schema)