Skip to main content
GET
/
data
/
projects
/
{projectId}
/
exports
List Exports
curl --request GET \
  --url https://partner.peaka.studio/api/v1/data/projects/{projectId}/exports \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "4c9fcb44-126a-45f8-99a0-f1d245083d78",
    "status": "SUCCEEDED",
    "format": "JSONL",
    "compression": "NONE",
    "rowCount": 993,
    "bytes": 3706920,
    "durationMs": 1055,
    "downloadable": true,
    "queryId": "709922802836177297",
    "source": "peaka.query.\"charges_view\"",
    "userName": "user@example.com",
    "apiKeyPrefix": "hBWIQxjc",
    "clientSource": "peaka-studio",
    "createdAt": "2026-06-10T12:24:08Z"
  },
  {
    "id": "2f1a9c77-8b3e-4d21-9a5c-1e7f0b2d4a90",
    "status": "RUNNING",
    "format": "CSV",
    "compression": "GZIP",
    "downloadable": false,
    "catalogId": "367189801096446904",
    "schemaName": "payment",
    "tableName": "charges",
    "source": "peaka.payment.\"charges\"",
    "userName": "user@example.com",
    "apiKeyPrefix": "hBWIQxjc",
    "clientSource": "peaka-api",
    "createdAt": "2026-06-10T12:20:31Z"
  },
  {
    "id": "9d8c7b6a-5e4f-3210-bca9-87654321fedc",
    "status": "FAILED",
    "format": "CSV",
    "downloadable": false,
    "error": "Query exceeded the 1,000,000 row export limit",
    "queryId": "709922802836177297",
    "source": "peaka.query.\"charges_view\"",
    "userName": "user@example.com",
    "apiKeyPrefix": "hBWIQxjc",
    "clientSource": "peaka-studio",
    "createdAt": "2026-06-10T12:11:02Z"
  }
]

Authorizations

Authorization
string
header
required

Use the Authorization header with the value 'Bearer ' to authenticate. Partner API Keys have full access; Project API Keys are limited to their project scope. Learn more: https://docs.peaka.com/api-reference/authentication

Path Parameters

projectId
string
required

ID of the Project

Query Parameters

status
string

Comma-separated status filter: PENDING,RUNNING,SUCCEEDED,FAILED,CANCELLED. Examples: SUCCEEDED,RUNNING (active or done), FAILED,CANCELLED (unsuccessful), SUCCEEDED (single status). Omit to return every status.

limit
integer<int32>

Page size, clamped to [1, 200]

createdBefore
string

Keyset cursor (ISO-8601): the previous page's last createdAt. Example: 2026-06-10T15:23:26.893985Z. Omit for the first page.

Response

200 - application/json

List of export jobs

id
string

Export job id

Example:

"4c9fcb44-126a-45f8-99a0-f1d245083d78"

status
enum<string>

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.

Available options:
PENDING,
RUNNING,
SUCCEEDED,
FAILED,
CANCELLED,
EXPIRED
Example:

"SUCCEEDED"

format
string

Output format

Example:

"JSONL"

compression
string

Output compression

Example:

"NONE"

rowCount
integer<int64>

Number of exported rows

Example:

993

bytes
integer<int64>

Total output size in bytes

Example:

3706920

durationMs
integer<int64>

Execution time in milliseconds

Example:

1055

files
object[]

Downloadable artifacts (only for the owner of a SUCCEEDED job)

expiresAt
string

Expiry of the presigned URLs (ISO-8601); re-call GET for fresh links

Example:

"2026-06-10T13:24:20Z"

downloadable
boolean

Whether the calling user may download this export (owner-only access)

Example:

true

error
string

Error message when the job failed

createdAt
string

Submission time (ISO-8601)

Example:

"2026-06-10T12:24:08Z"

queryId
string

Source query id (query exports)

Example:

"709922802836177297"

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

Example:

"peaka.query.\"charges_view\""

userId
string

Initiator user id

userName
string

Initiator user name

Example:

"user@example.com"

apiKeyPrefix
string

Public prefix of the initiator's API key

Example:

"hBWIQxjc"

clientSource
string

Client source (X-Trino-Source, falling back to User-Agent)

Example:

"peaka-studio"