Sign in

v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01105276529.8 KB
traces

List traces for a project

get/v1/projects/{project_identifier}/traces

Path parameters

project_identifierstring required

The project identifier: either project ID or project name.

The project identifier: either project ID or project name.

Query parameters

start_timestring date-time nullable

Inclusive lower bound on trace start time (ISO 8601)

Inclusive lower bound on trace start time (ISO 8601)

end_timestring date-time nullable

Exclusive upper bound on trace start time (ISO 8601)

Exclusive upper bound on trace start time (ISO 8601)

sort'start_time' | 'latency_ms'

Sort field

Sort field

order'asc' | 'desc'

Sort direction

Sort direction

limitinteger

Maximum number of traces to return

Maximum number of traces to return

cursorstring nullable

Pagination cursor (Trace GlobalID)

Pagination cursor (Trace GlobalID)

include_spansboolean

If true, include full span details for each trace. This significantly increases response size and query latency, especially with large page sizes. Prefer fetching spans lazily for individual traces when possible.

If true, include full span details for each trace. This significantly increases response size and query latency, especially with large page sizes. Prefer fetching spans lazily for individual traces when possible.

session_identifierstring[] nullable

List of session identifiers to filter traces by. Each value can be either a session_id string or a session GlobalID. Only traces belonging to the specified sessions will be returned.

List of session identifiers to filter traces by. Each value can be either a session_id string or a session GlobalID. Only traces belonging to the specified sessions will be returned.

Response

Successful Response

next_cursorstring nullable required