Skip to main content
POST
List traces

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Query Parameters

limit
integer
default:25

Maximum items to return. Defaults to 25 if omitted; maximum is 50.

Required range: 1 <= x <= 50
cursor
string

Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.

Body

application/json

Body containing trace query parameters

project_id
string
required

The project ID to list traces for

start_time
string<date-time>

Return traces whose spans start at or after this timestamp (inclusive). ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Defaults to 1 week ago.

end_time
string<date-time>

Return traces whose spans start at or before this timestamp (inclusive). ISO 8601 format (e.g., 2024-01-02T00:00:00Z). Defaults to the current time.

filter
string

Filter expression to apply to the query. Supports SQL-like syntax for filtering spans by attributes (e.g., status_code = 'ERROR' or span_kind = 'LLM'). A trace is returned when any of its spans matches the filter — the matching span is usually a child, not the root. Optional; omit it to apply no filter. If provided, it must not be empty or whitespace-only.

Response

Returns a list of traces

traces
object[]
required

A list of root-based trace entries ordered by root span start_time from newest to oldest. The root trace and span identifiers give entries with the same start time a stable order.

pagination
object
required

Pagination metadata for cursor-based navigation. A cursor keeps the resolved time window fixed and applies only to root selection. It is valid only for the same project, filter, and sort order. A page walk is not a snapshot: data that arrives after the first request can affect later pages.