---
title: "List the project's export jobs, newest first"
method: GET
path: "/v1/projects/{project_id}/exports"
tags: ["exports"]
---

# List the project's export jobs, newest first

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

## Request

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

Any org member. Returns each job's status, ordered progress steps and row/byte counters.

## Path parameters

- `project_id` string, required

## Query parameters

- `limit` integer: page size; 0 or absent means 50
- `cursor` string: next_cursor from the previous page; absent for the first page

## Response `200`

OK

- ExportPage
  - `data` ExportView[], required
    - `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
  - `next_cursor` string, nullable, required: pass as cursor to fetch the next page; null on the last page

## 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)