Skip to main content
GET
Get span export status

Authorizations

x-api-key
string
header
required

Headers

x-selected-account-id
string | null

Path Parameters

export_id
string
required

Response

Successful Response

Status for GET /v5/spans/export/{export_id} (mirrors the sgp-traces status object).

Always returned with HTTP 200; unknown or cross-account ids arrive as failed with reason=not_found.

export_id
string
required

The export id echoed back.

status
enum<string>
required

Lifecycle state.

Available options:
running,
succeeded,
failed
run_id
string | null

Temporal run id of the export workflow.

rows_written
integer | null

Rows written so far (running).

bytes_written
integer | null

Bytes written so far (running).

shards_completed
integer | null

Export shards completed so far (running). A shard here is one of the export's concurrent read windows over the export time range, not a storage shard.

shards_total
integer | null

Total shards in the export plan, the time windows the export window is split into for concurrent reads (running).

filename
string | null

Name of the exported file (succeeded).

signed_url
string | null

Pre-signed download URL (succeeded).

expires_at
string<date-time> | null

When the signed URL expires.

from_ts
string<date-time> | null

Resolved start of the window.

to_ts
string<date-time> | null

Resolved end of the window.

snapshot_ts
string<date-time> | null

Snapshot the export read at.

truncated
SpansExportTruncation · object | null

Present when the export hit a budget.

staged_file
SpansExportStagedFile · object | null

The export artifact's commit handle in the Datasets workspace grant, present only for a staged export (succeeded); signed_url is absent in that case.

reason
string | null

Terminal failure reason (failed): not_found (unknown or cross-account export id, or a result that expired or predates the object-storage cutover), invalid_input (the request was rejected, and guidance names what to change), resource_exhausted, timed_out, resume_cursor_stale (the resume cursor does not match how this export is ordered), canceled, terminated, failed (no cause recorded), or internal (server-side fault).

guidance
string | null

Human-readable, actionable next step for a failed export (failed).