Skip to main content
GET
List traces for a project

Path Parameters

project_identifier
string
required

The project identifier: either project ID or project name.

Query Parameters

start_time
string<date-time> | null

Inclusive lower bound on trace start time (ISO 8601)

end_time
string<date-time> | null

Exclusive upper bound on trace start time (ISO 8601)

sort
enum<string>
default:start_time

Sort field

Available options:
start_time,
latency_ms
order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
limit
integer
default:100

Maximum number of traces to return

Required range: x <= 1000
cursor
string | null

Pagination cursor returned by a previous request

include_spans
boolean
default:false

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_identifier
string[] | null

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.

error
boolean | null
deprecated

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_ms
number | null
deprecated

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

Required range: x >= 0
max_latency_ms
number | null
deprecated

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

Required range: x >= 0
filter
string | null

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

data
TraceData · object[]
required
next_cursor
string | null
required