List spans
List individual spans using UQL (Uptrace Query Language). Use this to inspect specific span details, search for errors, or browse recent operations. Supports WHERE filters (e.g. where service_name = 'myservice', where _status_code = 'error', where _dur_ms > 100ms), full-text search (e.g. word1|word2 -excluded), system filtering (e.g. httpserver:all, db:postgresql, log:error), duration filtering in milliseconds, and sorting by any span field. Span fields use underscore prefix: _name, _dur_ms, _status_code, _time, _trace_id, _kind. Attributes use dot-to-underscore: service.name becomes service_name. Returns individual span objects with attrs, timing, and status. Use list_span_groups instead when you need aggregated metrics (count, avg, p99). Use list_traces instead when you need to find traces matching multi-span criteria. Documentation: https://uptrace.dev/features/querying/spans
Path parameters
Uptrace project ID.
Query parameters
RFC3339 timestamp.
Start time (inclusive) as RFC3339 timestamp.
RFC3339 timestamp.
End time (exclusive) as RFC3339 timestamp.
UQL query to filter spans (e.g., where service_name = 'myservice').
Additional WHERE clause appended to the query.
Full-text search for spans containing the given text.
Attribute names to search within when using search. Can be repeated for multiple attributes.
Filter by system (e.g., log:error, db:postgresql). Can be repeated for multiple systems.
Column names to sort by. Can be repeated for multi-column sort. Defaults to time.
Sort direction for each sort_by column. Must match sort_by count. Defaults to DESC.
Duration greater than or equal to N (milliseconds).
Duration less than N (milliseconds).
Limit number of results.
Response
List of matching spans.