Skip to main content

Query Traces

POST 
/traces/query

Query traces as a list of canonical Trace records.

Thin wrapper over the shared span-query backend that forces focus = "trace" and returns the list-shaped Traces payload (one entry per trace, each with its nested spans tree). Use this to build a table of runs, where each row is a trace.

Request body​

  • filtering — span-level conditions, same dialect as POST /spans/query. A trace matches when any of its spans matches.
  • windowing — cursor pagination and time range.
  • query_ref, query_variant_ref, query_revision_ref — resolve filters and windowing from a saved query revision. If the revision's stored formatting.focus is span, this endpoint returns 409 — call POST /spans/query instead.

Response​

Returns {count, traces: [...]}. For the per-trace map shape keyed by trace_id, call POST /tracing/spans/query with focus="trace".

Request​

Responses​

Successful Response