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

Temporal run id of the export workflow.

rows_written
integer

Rows written so far (running).

bytes_written
integer

Bytes written so far (running).

shards_completed
integer

Shards completed so far (running).

shards_total
integer

Total shards in the plan (running).

filename
string

Name of the exported file (succeeded).

signed_url
string

Pre-signed download URL (succeeded).

expires_at
string<date-time>

When the signed URL expires.

from_ts
string<date-time>

Resolved start of the window.

to_ts
string<date-time>

Resolved end of the window.

snapshot_ts
string<date-time>

Snapshot the export read at.

truncated
SpansExportTruncation · object

Present when the export hit a budget.

reason
string

Terminal failure reason, incl. not_found.

guidance
string

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