Skip to main content
GET
List Traces

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:50

Items per page

Required range: 1 <= x <= 200
start_after
string<date-time> | null

Only traces that started at or after this time (inclusive, ISO 8601)

end_before
string<date-time> | null

Only traces that started before this time (exclusive, ISO 8601)

include_evaluations
boolean
default:false

Include traces produced by offline-evaluation runs. Excluded by default so evaluation runs do not appear in the production trace list.

name
string | null

Filter by trace name (substring match)

user_id
string | null

Filter by the user id recorded on the trace

search_query
string | null

Search across trace_id, name, session_id, user_id

project_id
string | null

Target project for the request. Required when authenticating with a user session token (a user credential is only meaningful scoped to a project); for an API key it is optional and, if given, must match the key's project.

Response

Successful Response

Paginated list of traces for the public API.

data
PublicTraceListItem · object[]
required
meta
PaginationMeta · object
required

Pagination metadata for list responses.