---
title: "Get an export and its download link"
method: GET
path: "/v1/exports/{export_id}"
tags: ["exports"]
---

# Get an export and its download link

`GET /v1/exports/{export_id}`

## Request

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

## Path parameters

- `export_id` string, required

## Response `200`

The export; while completed, a download link fresh for 15 minutes. Never cached.

- ExportSummary
  - `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
            - ProfileSearchTerm
              - …
            - ProfileSearchAny
              - …
  - `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

## 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.
- `404`: Not found
- `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)