---
title: "List exports"
method: GET
path: "/v1/exports"
tags: ["exports"]
---

# List exports

`GET /v1/exports`

## Request

- Base URL: `https://api.octaneai.com`
- URL: `https://api.octaneai.com/v1/exports`
- Auth: HTTP bearer

## Query parameters

- `cursor` string, nullable: From the previous page's nextCursor
- `limit` integer

## Response `200`

One page of the store's exports, newest first, without download links.

- ExportList
  - `data` ExportSummary[], required: The exports, newest first
    - `id` string, required: The export
    - `dataset` 'profiles' | 'responses' | 'quiz_analytics' | 'audit_events', required: What the file holds
    - `format` 'csv' | 'json', required: The file's format
    - `source` 'api' | 'dashboard', required: Where the export was requested
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'expired', required: pending | running | completed | failed | expired
    - `filters` ExportFilters, required
      - `quiz_id` string, nullable: Only this quiz (profiles and responses)
      - `from` string, date, nullable: First day, inclusive, UTC
      - `to` string, date, nullable: Last day, inclusive, UTC
      - `tz` string, nullable: quiz_analytics only: the timezone the days are counted in
      - `search` ProfileSearch: Who to find: the list filters of GET /v1/profiles except q, plus person facts and an answer filter, an OR of AND groups. Send the same body with every page: a cursor belongs to the search that answered it and is refused with any other body.
        - `quiz_id` string, nullable: Only people who took this quiz
        - `from` string, date, nullable: Last seen on or after this UTC day
        - `to` string, date, nullable: Last seen on or before this UTC day
        - `has_order` boolean, nullable: Placed an order we linked to a quiz session
        - `has_email` boolean, nullable: Has an email
        - `has_phone` boolean, nullable: Has a phone
        - `has_marketing_consent` boolean, nullable: Ticked the marketing-consent checkbox beside their newest email or phone answer
        - `is_returning` boolean, nullable: Took a quiz again after we first knew them, on any device
        - `match` 'any_session' | 'latest_completed_per_quiz': any_session: any time they took the quiz counts; latest_completed_per_quiz: only their latest completed take of each quiz
        - `groups` ProfileSearchGroup[], nullable: OR of AND groups: up to 4 groups of 8 terms
          - `all` union[], required: Every slot must hold: a term, or {any: [terms]}; at most 8 terms in the group, counting the terms inside any
            - union
              - …
    - `row_count` integer, nullable, required: Rows in the file; null until completed
    - `bytes` integer, nullable, required: The file's size in bytes; null until completed
    - `error` string, nullable, required: Why the build failed; null otherwise
    - `requested_at` string, date-time, required: When the export was requested
    - `started_at` string, date-time, nullable, required: When the build started; null before
    - `completed_at` string, date-time, nullable, required: When the file was ready; null before
    - `expires_at` string, date-time, required: When the export and its file are deleted
    - `download_url` string, nullable: Set on GET /v1/exports/{export_id} while completed; valid 15 minutes
    - `download_url_expires_at` string, date-time, nullable: When download_url stops working; null with it
    - `urls` object, required: self: this export on the API; fetch it for a fresh download link
  - `has_more` boolean, required: Whether another page follows
  - `next_cursor` string, nullable, required: Send as cursor for the next page; null on the last

## Other responses

- `401`: The key is missing, malformed, revoked or expired.
- `403`: The store's plan has no API access, or the key lacks the scope.
- `422`: A request parameter is invalid.
- `429`: The key's or the store's bucket is full; Retry-After says when to try again.
- `504`: The request timed out.

---

[API](https://skmtc.dev/octaneai/apis/octane-ai-merchant-api.md) - [All operations](https://skmtc.dev/octaneai/apis/octane-ai-merchant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octaneai/apis/octane-ai-merchant-api/revisions/dc2d1aa2b7c6?raw)