Skip to main content
GET
List project trace spans

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Project slug or UUID. The resolved project is used to scope all trace reads server-side.

trace_id
string
required

Trace ID from Grafana Cloud Tempo.

Query Parameters

cursor
string

Opaque continuation from page_info.next or page_info.prev.

Required string length: 1 - 4096
limit
integer
default:200

Max spans to return (default: 200, max: 1000).

Required range: 1 <= x <= 1000
status
enum<string>

Optional span status filter. Use ok, error, unset, or unknown.

Available options:
ok,
error,
unset,
unknown
sort_order
enum<string>
default:asc

Order by span start time. Defaults to "asc".

Available options:
asc,
desc

Response

Trace spans

data
object[]
required
page_info
object
required