API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Traces

List traces (root spans)

client.traces.list(TraceListParams { agent, duration_ns__gte, duration_ns__lte, 22 more } query?, RequestOptionsoptions?): TraceListResponse { count, results, next, previous }

GET/api/traces/

Get a trace and all its spans

client.traces.retrieve(stringtraceID, RequestOptionsoptions?): TraceRetrieveResponse { root, span_count, spans, trace_id }

GET/api/traces/{trace_id}/

List distinct service names visible to the caller

client.traces.listServices(TraceListServicesParams { agent, duration_ns__gte, duration_ns__lte, 22 more } query?, RequestOptionsoptions?): TraceListServicesResponse { count, results, next, previous }

GET/api/traces/services/