Sign in
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 returned by a previous request

Pagination cursor returned by a previous request

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

Changes

Changed in 2 of the 70 revisions of this API.33

  • 29fe492bf1e23See the full diff
    • ○

      added the optional property data/items/token_count_completion to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/token_count_prompt to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/items/token_count_total to the response with the 200 status

      response-optional-property-added

  • c81391216eb53See the full diff
    • ●

      removed the optional property data/items/token_count_completion from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/items/token_count_prompt from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/items/token_count_total from the response with the 200 status

      response-optional-property-removed

    This revision also has 91 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog