TRtraceroot
Traces

List Traces

List recent traces for the caller's project (newest first).

Offline-evaluation traces are excluded by default; pass include_evaluations=true to include them.

get/api/v1/public/traces

Request

  • Base URL
    https://app.traceroot.ai
  • URL
    https://app.traceroot.ai/api/v1/public/traces
  • Auth
    HTTP bearer

Query parameters

limitinteger

Items per page

start_afterstring date-time nullable

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

end_beforestring date-time nullable

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

include_evaluationsboolean

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

namestring nullable

Filter by trace name (substring match)

user_idstring nullable

Filter by the user id recorded on the trace

search_querystring nullable

Search across trace_id, name, session_id, user_id

JSON array of typed filter predicates ({field, op, value}); the field catalog and per-field operators are defined in the schema

project_idstring nullable

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

Changes

No recorded changes to this operation across all 1 revision of this API.