Skip to main content
GET
/
data
/
projects
/
{projectId}
/
exports
/
{exportId}
Read Export
curl --request GET \
  --url https://partner.peaka.studio/api/v1/data/projects/{projectId}/exports/{exportId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "4c9fcb44-126a-45f8-99a0-f1d245083d78",
  "status": "SUCCEEDED",
  "format": "JSONL",
  "compression": "NONE",
  "rowCount": 993,
  "bytes": 3706920,
  "durationMs": 1055,
  "files": [
    {
      "name": "query_709922802836177297_charges.jsonl",
      "url": "https://<minio>/export/...&X-Amz-Signature=...",
      "bytes": 3706920
    }
  ],
  "expiresAt": "2026-06-10T13:24:20Z",
  "downloadable": true,
  "error": "<string>",
  "createdAt": "2026-06-10T12:24:08Z",
  "queryId": "709922802836177297",
  "catalogId": "<string>",
  "schemaName": "<string>",
  "tableName": "<string>",
  "source": "peaka.query.\"charges_view\"",
  "userId": "<string>",
  "userName": "user@example.com",
  "apiKeyPrefix": "hBWIQxjc",
  "clientSource": "peaka-studio"
}

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

exportId
string
required

Export job id (UUID)

Response

Export job status

Status and result of an export job

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"