--- title: "GET /v2/customers/exports" method: GET path: "/v2/customers/exports" tags: ["customerExports"] --- # GET /v2/customers/exports `GET /v2/customers/exports` ## Request - Base URL: `https://api.loyaltylion.com` - URL: `https://api.loyaltylion.com/v2/customers/exports` - Auth: HTTP bearer ## Query parameters - `limit` integer - `cursor` string: Fetch another page of results using a cursor returned in a previous response ## Response `200` 200 - CustomerExportsListCustomerExportsResponseBody - `exports` CustomerExport[], required - union: An export moves from `pending` to `processing` to `completed`, and to `expired` once its file is deleted seven days later; a run that cannot finish ends `failed`. Which fields are present depends on its `status` - object - `id` number, required - `filters` object, required: The filters this export was requested with - `created_at_min` string: Return only customers created on or after the specified `ISO 8601` datetime string - `created_at_max` string: Return only customers created before the specified `ISO 8601` datetime string - `updated_at_min` string: Return only customers updated on or after the specified `ISO 8601` datetime string - `updated_at_max` string: Return only customers updated before the specified `ISO 8601` datetime string - `created_at` string, required: When the export was requested, as an ISO 8601 timestamp - `status` 'pending', required: The export is queued and has not started - object - `id` number, required - `filters` object, required: The filters this export was requested with - `created_at_min` string: Return only customers created on or after the specified `ISO 8601` datetime string - `created_at_max` string: Return only customers created before the specified `ISO 8601` datetime string - `updated_at_min` string: Return only customers updated on or after the specified `ISO 8601` datetime string - `updated_at_max` string: Return only customers updated before the specified `ISO 8601` datetime string - `created_at` string, required: When the export was requested, as an ISO 8601 timestamp - `status` 'processing', required: The export is running - `started_at` string, required: When processing began, as an ISO 8601 timestamp - `progress` object, required - `rows_processed` number, required: How many customers have been written so far - `rows_total` number, nullable, required: Roughly how many customers the export will write, for showing progress against. An approximation, re-estimated whenever processing starts or resumes, so it can change or become null while the export runs; `rows_processed` is the truth. Null when no estimate was available - object - `id` number, required - `filters` object, required: The filters this export was requested with - `created_at_min` string: Return only customers created on or after the specified `ISO 8601` datetime string - `created_at_max` string: Return only customers created before the specified `ISO 8601` datetime string - `updated_at_min` string: Return only customers updated on or after the specified `ISO 8601` datetime string - `updated_at_max` string: Return only customers updated before the specified `ISO 8601` datetime string - `created_at` string, required: When the export was requested, as an ISO 8601 timestamp - `started_at` string, required: When processing began, as an ISO 8601 timestamp - `completed_at` string, required: When the file was written, as an ISO 8601 timestamp - `row_count` number, required: How many customers the file holds, one per line - `file_size` number, required: Size of the file in bytes - `status` 'completed', required: The export finished and its file is available for download - `expires_at` string, required: When the file is deleted, seven days after the export completed, as an ISO 8601 timestamp. The export is `expired` from then on - `download_url` string, required: A signed link to the file, minted for this response and valid for six hours. Read the export again for a fresh link - `download_url_expires_at` string, required: When the link in `download_url` stops working, as an ISO 8601 timestamp - object - `id` number, required - `filters` object, required: The filters this export was requested with - `created_at_min` string: Return only customers created on or after the specified `ISO 8601` datetime string - `created_at_max` string: Return only customers created before the specified `ISO 8601` datetime string - `updated_at_min` string: Return only customers updated on or after the specified `ISO 8601` datetime string - `updated_at_max` string: Return only customers updated before the specified `ISO 8601` datetime string - `created_at` string, required: When the export was requested, as an ISO 8601 timestamp - `started_at` string, required: When processing began, as an ISO 8601 timestamp - `completed_at` string, required: When the file was written, as an ISO 8601 timestamp - `row_count` number, required: How many customers the file holds, one per line - `file_size` number, required: Size of the file in bytes - `status` 'expired', required: The file was deleted, seven days after the export completed. Request another export for a fresh file - `expired_at` string, required: When the file was deleted, as an ISO 8601 timestamp - object - `id` number, required - `filters` object, required: The filters this export was requested with - `created_at_min` string: Return only customers created on or after the specified `ISO 8601` datetime string - `created_at_max` string: Return only customers created before the specified `ISO 8601` datetime string - `updated_at_min` string: Return only customers updated on or after the specified `ISO 8601` datetime string - `updated_at_max` string: Return only customers updated before the specified `ISO 8601` datetime string - `created_at` string, required: When the export was requested, as an ISO 8601 timestamp - `status` 'failed', required: The export failed. It produced no file and will not be retried; request another one - `started_at` string, nullable, required: When processing began, as an ISO 8601 timestamp. Null if the export failed before it started - `failed_at` string, required: When the export failed, as an ISO 8601 timestamp - `cursor` object, required: Cursors that can be used to fetch the previous or next page of results. If a cursor is `null`, it means there are no more results in that direction - `prev` string, nullable, required - `next` string, nullable, required ## Other responses - `400`: Bad Request - `401`: 401 - `403`: 403 ## Changes - **2026-11-03** `69cbd7bf7128`: 1 info - endpoint added [Operation history](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/changes/v2/customers/exports/get.md) --- [API](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api.md) - [All operations](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/revisions/69cbd7bf7128?raw)