Querying
List spans
List spans (public API). Stable API for listing spans by trace_id, span_id, or parent_id. Best for retrieving known spans when you already have an ID. For advanced filtering with UQL queries (WHERE, search, system filtering), use list_spans instead. Documentation: https://uptrace.dev/features/querying/spans
get/api/v1/tracing/{project_id}/spans
Path parameters
project_idinteger required
Uptrace project ID.
Query parameters
time_startstring date-time required
RFC3339 timestamp.
Start time (inclusive) as RFC3339 timestamp.
time_endstring date-time required
RFC3339 timestamp.
End time (exclusive) as RFC3339 timestamp.
trace_idstring
Filter spans by trace ID.
idinteger
Filter spans by span ID.
parent_idinteger
Filter spans by parent span ID.
limitinteger
Limit number of results.
Response
List of spans.