---
title: "Read Export"
method: GET
path: "/data/projects/{projectId}/exports/{exportId}"
tags: ["Data -- Exports"]
---

# Read Export

`GET /data/projects/{projectId}/exports/{exportId}`

## Request

- Base URL: `https://partner.peaka.studio/api/v1`
- URL: `https://partner.peaka.studio/api/v1/data/projects/{projectId}/exports/{exportId}`
- Auth: HTTP bearer

Returns the status of a single export job. For a SUCCEEDED job owned by the caller, `files` carries freshly-presigned download URLs; non-owners get the row with `downloadable=false`.

## Path parameters

- `projectId` string, required
- `exportId` string, required

## Response `200`

Export job status

- ExportJobResponse: Status and result of an export job
  - `id` string: Export job id
  - `status` 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'EXPIRED': Job status. EXPIRED is derived when the artifacts have been removed by the lifecycle rule; exports are point-in-time snapshots and are never regenerated.
  - `format` string: Output format
  - `compression` string: Output compression
  - `rowCount` integer: Number of exported rows
  - `bytes` integer: Total output size in bytes
  - `durationMs` integer: Execution time in milliseconds
  - `files` ExportFile[]: Downloadable artifacts (only for the owner of a SUCCEEDED job)
    - `name` string: File name
    - `url` string: Presigned download URL (short-lived)
    - `bytes` integer: Object size in bytes
  - `expiresAt` string: Expiry of the presigned URLs (ISO-8601); re-call GET for fresh links
  - `downloadable` boolean: Whether the calling user may download this export (owner-only access)
  - `error` string: Error message when the job failed
  - `createdAt` string: Submission time (ISO-8601)
  - `queryId` string: Source query id (query exports)
  - `catalogId` string: Source catalog id (table exports)
  - `schemaName` string: Source schema name (table exports)
  - `tableName` string: Source table name (table exports)
  - `source` string: Quoted, fully-qualified source name for display
  - `userId` string: Initiator user id
  - `userName` string: Initiator user name
  - `apiKeyPrefix` string: Public prefix of the initiator's API key
  - `clientSource` string: Client source (X-Trino-Source, falling back to User-Agent)

## Other responses

- `404`: Export job not found

---

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