Query Spans

Query spans as a flat list.

Thin wrapper over the shared span-query backend that forces focus = "span". Use this when you want a paged list of spans regardless of trace hierarchy — for example, to surface all LLM calls across traces or to stream spans into an external system.

Request body

• filtering — span-level conditions (fields on Span and attributes paths).
• windowing — cursor pagination and time range (see Query Pattern).
• query_ref, query_variant_ref, query_revision_ref — resolve filtering and windowing from a saved query revision. If the revision's stored formatting.focus is trace, this endpoint returns 409 — call POST /traces/query for that revision.

Response

Returns {count, spans}. For the nested per-trace shape, call POST /traces/query or POST /tracing/spans/query with focus="trace" instead.