LAlatitude-dev
Traces

Get project trace

Changed on

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}

Request

  • Base URL
    https://api.latitude.so
  • Auth
    HTTP bearer

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier). The CLI can also read this from the LATITUDE_PROJECT_SLUG environment variable.

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 (100,000,000 per USD).

costOutputMicrocentsnumber required

Cost of output tokens in microcents (100,000,000 per USD).

costTotalMicrocentsnumber required

Total cost in microcents (100,000,000 per 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.

Changes

  • f4019a0ecb56Revision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added the required property to the response with the status

  • 55192261472dRevision changes
    • breaking

      the response's property type changed from object to array for status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status