---
title: "Get one export job's status and progress"
method: GET
path: "/v1/projects/{project_id}/exports/{job_id}"
tags: ["exports"]
---

# Get one export job's status and progress

`GET /v1/projects/{project_id}/exports/{job_id}`

## Request

- Base URL: `https://api.wavehouse.cloud`
- URL: `https://api.wavehouse.cloud/v1/projects/{project_id}/exports/{job_id}`
- Auth: one of:
  - API key in cookie `whc_session`
  - HTTP bearer
  - API key in header `X-API-Key`

Any org member. Poll this while an export runs: `steps` is the ordered checkpoint list and `rows_done`/`bytes_done` advance per table.

## Path parameters

- `project_id` string, required
- `job_id` string, required

## Response `200`

OK

- ExportView
  - `attempt` integer, required
  - `bytes_done` integer, required
  - `cancel_requested` boolean
  - `created_at` string, date-time, required
  - `finished_at` string, date-time
  - `format` string, required: native | parquet
  - `job_id` string, required
  - `last_error` string
  - `query_id` string: the engine query_id of the statement most recently issued for this job
  - `rows_done` integer, required
  - `started_at` string, date-time
  - `status` string, required: queued | running | succeeded | failed | dead | cancelled
  - `steps` ExportStepView[], required
    - `detail` string
    - `done_at` string, date-time: absent while pending
    - `name` string, required: plan | credential | schema:<table> | data:<table> | cancelled
    - `status` string, required: pending | done | failed
  - `tables` string[]: the requested tables; empty means the whole project database

## Other responses

- `429`: Rate limited, per client IP, API key or org; a client IP is also refused on every route for a while after repeated authentication failures. A limited operation carries RateLimit-Policy and RateLimit on every response; wait Retry-After seconds before retrying.
- `default`: Error

---

[API](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api.md) · [All operations](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/revisions/adea029bf505?raw)