v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124241726.5 KB

Traces

Get project trace

Returns a single trace by id, including its conversation: the system instructions and the messages of the trace's last LLM-completion span, in OpenTelemetry GenAI format.

get/v1/projects/{projectSlug}/traces/{traceId}

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

traceIdstring required

32-character trace identifier.

Response

Trace detail

organizationIdstring required

Organization that owns this trace.

projectIdstring required

Project this trace belongs to.

traceIdstring required

32-character trace identifier.

spanCountinteger required

Total number of spans in the trace.

errorCountinteger required

Number of spans flagged with an error status.

startTimestring required

ISO-8601 timestamp of the trace's earliest span.

endTimestring required

ISO-8601 timestamp of the trace's latest span.

durationNsnumber required

Wall-clock duration of the trace in nanoseconds.

timeToFirstTokenNsnumber required

Nanoseconds from the start of the first LLM span to its first emitted token. 0 if not measured.

tokensInputnumber required

Total input tokens across LLM spans.

tokensOutputnumber required

Total output tokens across LLM spans.

tokensCacheReadnumber required

Total tokens served from the provider's prompt cache.

tokensCacheCreatenumber required

Total tokens written to the provider's prompt cache.

tokensReasoningnumber required

Total reasoning tokens reported by the model.

tokensTotalnumber required

Sum of all token counters.

costInputMicrocentsnumber required

Cost of input tokens in microcents (1/1,000,000 USD).

costOutputMicrocentsnumber required

Cost of output tokens in microcents (1/1,000,000 USD).

costTotalMicrocentsnumber required

Total cost in microcents (1/1,000,000 USD).

sessionIdstring nullable required

Conversation/session identifier set by the SDK. null when absent.

userIdstring nullable required

End-user identifier set by the SDK. null when absent.

simulationIdstring nullable required

CUID of the simulation that produced this trace. null when not a simulation.

tagsstring[] required

Free-form tags attached at ingest time.

modelsstring[] required

Model identifiers seen across the trace's LLM spans.

providersstring[] required

LLM-provider identifiers seen across the trace's spans.

serviceNamesstring[] required

OpenTelemetry service.name values seen in the trace.

rootSpanIdstring nullable required

Identifier of the trace's root span. null when no root span has been ingested.

rootSpanNamestring nullable required

name attribute of the root span. null when no root span has been ingested.

positiveAnnotationCountinteger required

Number of passed = true annotations attached to this trace.

negativeAnnotationCountinteger required

Number of passed = false annotations attached to this trace.

metadataobject required

Free-form metadata attached at ingest time.

conversationGenAIMessage[] required

Full conversation for the trace, in OpenTelemetry GenAI format: the system instructions, then the messages sent into the trace's last LLM-completion span (the running history at that point), followed by that span's generated output.