traces

List traces for a project

Changed on
get/v1/projects/{project_identifier}/traces

Request

  • The document declares no server URL.
  • Auth
    none declared

Path parameters

project_identifierstring required

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)

end_timestring date-time nullable

Exclusive upper bound on trace start time (ISO 8601)

sort'start_time' | 'latency_ms'

Sort field

order'asc' | 'desc'

Sort direction

limitinteger

Maximum number of traces to return

cursorstring nullable

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.

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.

errorboolean nullable

Deprecated: use filter=error_count > 0 or filter=error_count == 0. Filter by trace error status. If true, only return traces that contain at least one span with status_code == ERROR. If false, only return traces with no errored spans. If omitted, traces are not filtered by error status.

min_latency_msnumber nullable

Inclusive lower bound on trace latency in milliseconds. Deprecated: use filter=latency_ms >= N.

max_latency_msnumber nullable

Inclusive upper bound on trace latency in milliseconds. Deprecated: use filter=latency_ms <= N.

filterstring nullable

Trace filter expression, as documented at https://arize.com/docs/phoenix/tracing/how-to-tracing/filter-expressions. Combined with other filters using AND. Empty expressions do not filter. Invalid expressions return 400.

Response

Successful Response

next_cursorstring nullable required

Changes

    • info

      added the new optional query request parameter filter

    • info

      query request parameter error was deprecated

    • info

      query request parameter max_latency_ms was deprecated

    • info

      query request parameter min_latency_ms was deprecated

    • info

      added the non-success response with the status

    • info

      added the new optional query request parameter error

    • info

      added the new optional query request parameter max_latency_ms

    • info

      added the new optional query request parameter min_latency_ms