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

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 before this timestamp (exclusive). 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 traces, ordered newest-first.

pagination
object
required

Pagination metadata for cursor-based navigation