> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trackplay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an export

> Poll an export's status. While it runs, `status` is `pending`. When it finishes, `status` is `ready` and `download_url` carries the link to the file. Fetch the file from there.

An export expires after a while. A finished-then-expired export returns `404`.

Requires a token with the `analytics:read` scope.

Server: `https://app.trackplay.io/api/v1`



## OpenAPI

````yaml /api-reference/openapi.json get /exports/{export}
openapi: 3.1.0
info:
  title: TrackPlay API
  description: >-
    Send conversions and events to TrackPlay, and read them back. Authenticated
    with scoped tokens you mint in the dashboard.
  version: 1.0.0
servers:
  - url: https://app.trackplay.io/api/v1
    description: App API. Conversions, videos, webhooks.
  - url: https://e.trackplay.io
    description: Events API. High-volume event ingest.
security:
  - bearerAuth: []
paths:
  /exports/{export}:
    get:
      tags:
        - Exports
      summary: Get an export
      description: >-
        Poll an export's status. While it runs, `status` is `pending`. When it
        finishes, `status` is `ready` and `download_url` carries the link to the
        file. Fetch the file from there.


        An export expires after a while. A finished-then-expired export returns
        `404`.


        Requires a token with the `analytics:read` scope.


        Server: `https://app.trackplay.io/api/v1`
      operationId: getExport
      parameters:
        - name: export
          in: path
          required: true
          schema:
            type: string
          description: >-
            The `export_id` returned when you started the export, e.g.
            `tpex_9f2c1a7e4d3b4a11`.
      responses:
        '200':
          description: >-
            The export's current status. Carries `download_url` once `status` is
            `ready`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExportStatusResponse'
              examples:
                pending:
                  summary: Still running
                  value:
                    export_id: tpex_9f2c1a7e4d3b4a11
                    status: pending
                    download_url: null
                ready:
                  summary: Finished, ready to download
                  value:
                    export_id: tpex_9f2c1a7e4d3b4a11
                    status: ready
                    download_url: >-
                      https://app.trackplay.io/api/v1/exports/tpex_9f2c1a7e4d3b4a11/download
        '401':
          description: >-
            `AUTH_REQUIRED`: no token sent. `INVALID_TOKEN`: the token is
            invalid, expired, or revoked.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: '`INSUFFICIENT_SCOPE`: the token does not carry `analytics:read`.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: No export with that ID, or it has expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              examples:
                not_found:
                  value:
                    error:
                      code: EXPORT_NOT_FOUND
                      message: Export not found or expired.
        '429':
          description: Rate limited. Reads are capped at 600 requests per minute per token.
components:
  schemas:
    ExportStatusResponse:
      type: object
      properties:
        export_id:
          type: string
          description: The export's ID.
        status:
          type: string
          enum:
            - pending
            - ready
          description: '`pending` while it runs, `ready` once the file is built.'
        download_url:
          type:
            - string
            - 'null'
          description: The link to the finished file. `null` until `status` is `ready`.
    ApiError:
      type: object
      description: The error shape the app API returns on a failed read or export.
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: >-
                A stable error code, e.g. `INSUFFICIENT_SCOPE`,
                `VIDEO_NOT_FOUND`, `EXPORT_NOT_FOUND`.
            message:
              type: string
              description: What went wrong, in plain English.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A scoped token minted in **Settings → API tokens**. Send it as
        `Authorization: Bearer tplt_…` or `X-API-Key: tplt_…`.

````