---
title: "Poll the status of a workspace export job"
method: GET
path: "/api/workspaces/{workspace}/export/{job_id}"
tags: ["Data Export"]
---

# Poll the status of a workspace export job

`GET /api/workspaces/{workspace}/export/{job_id}`

## Request

- Base URL: `https://www.audioscrape.com`
- URL: `https://www.audioscrape.com/api/workspaces/{workspace}/export/{job_id}`
- Auth: HTTP bearer

Returns the current lifecycle state of an export job. When `status` is
`completed`, `download_url` is populated with a signed URL that remains
valid until `download_expires_at`.

Caller must be a member of the workspace (any role).

## Path parameters

- `workspace` integer, required
- `job_id` integer, required

## Response `200`

Current status of the export job

- ExportJobStatus: Response from `GET /api/workspaces/{workspace}/export/{job_id}`.
  - `bytes` integer, nullable: Total size of the generated archive in bytes. `null` until completion.
  - `completed_at` string, nullable: RFC 3339 UTC timestamp the job reached a terminal state. `null` while in flight.
  - `created_at` string, nullable: RFC 3339 UTC timestamp the job was created.
  - `download_expires_at` string, nullable: RFC 3339 UTC timestamp at which `download_url` stops working.
  - `download_url` string, nullable: Signed download URL. Present only when `status == "completed"`.
  - `error_message` string, nullable: Human-readable failure reason. Set only when `status == "failed"`.
  - `id` integer, required: Numeric job ID.
  - `item_count` integer, nullable: Number of items packaged in the export. `null` until completion.
  - `status` string, required: One of `queued`, `running`, `completed`, `failed`, `expired`.

## Other responses

- `401`: Missing or invalid session / key
- `403`: Caller is not a member of the workspace
- `404`: Workspace or job not found

---

[API](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api.md) · [All operations](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/revisions/29b5788227cf?raw)