List traces
List individual traces using correlated sub-queries. Use this to find specific traces matching complex multi-span criteria. Requires parallel arrays: query[], alias[], system[] with matching lengths. One alias must be 'root' to identify the root span query. Additional sub-queries filter traces where child spans match specific criteria. Systems: spans:all, httpserver:all, db:postgresql, log:error, etc. Returns root spans for matching traces sorted by time (DESC by default). Use list_trace_groups instead when you need aggregated trace metrics. Use list_spans instead when you don't need cross-span trace correlation. 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 for each sub-query. Must have the same count as alias and system. Can be repeated.
Alias for each sub-query. One alias must be 'root'. Can be repeated.
System for each sub-query (e.g., spans:all, log:error). Can be repeated.
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.
Limit number of results.
Response
List of matching traces.