---
title: "Get export status"
method: GET
path: "/exports/{id}"
---

# Get export status

`GET /exports/{id}`

Returns the current status of an export job. Once `status` becomes
`completed`, `download_url` is populated with a signed URL valid for
~1 hour. `error_message` is populated only when `status` is `failed`.

## Path parameters

- `id` integer, required

## Headers

- `api_key` string, required

## Response `200`

Export record.

- object
  - `success` integer
  - `export` ExportRecord — Background export job. Statuses: 0=pending, 1=processing, 2=completed, 3=failed. `download_url` is signed and valid only while `download_expires_at` has not passed; call `GET /exports/{id}` again to obtain a fresh link.
    - `id` integer
    - `project_id` integer
    - `type` string
    - `subtype` string, nullable
    - `status` 0 | 1 | 2 | 3
    - `status_label` 'Pending' | 'Processing' | 'Completed' | 'Failed'
    - `file_name` string
    - `file_size` integer, nullable
    - `file_size_human` string
    - `mime_type` string, nullable
    - `parameters` object
    - `created_at` string, date-time
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `error_message` string, nullable — Populated only when status=failed.
    - `status_url` string, uri — URL of GET /exports/{id} — poll this until completed.
    - `download_url` string, uri, nullable — Short-lived signed URL to download the file. Null until status=completed.
    - `download_expires_at` string, date-time, nullable

---

[API](https://skmtc.net/web2wave/apis/web2wave-api.md) · [All operations](https://skmtc.net/web2wave/apis/web2wave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/web2wave/web2wave-api/versions/c88545119271/schema)