Skip to main content
GET
/
admin
/
api
/
v1
/
traces
/
{otel_trace_id}
Get Trace Detail
curl --request GET \
  --url https://api.example.com/admin/api/v1/traces/{otel_trace_id}
{
  "trace": {
    "otelTraceId": "<string>",
    "name": "<string>",
    "startedAt": "2023-11-07T05:31:56Z",
    "endedAt": "2023-11-07T05:31:56Z",
    "latencyMs": 123,
    "totalTokens": 123,
    "totalCostUsd": 123,
    "models": [
      "<string>"
    ],
    "status": "<string>",
    "userId": "<string>",
    "sessionId": "<string>",
    "tags": [
      "<string>"
    ]
  },
  "tree": [
    {
      "span": {
        "otelSpanId": "<string>",
        "otelTraceId": "<string>",
        "name": "<string>",
        "kind": "<string>",
        "startedAt": "2023-11-07T05:31:56Z",
        "parentSpanId": "<string>",
        "endedAt": "2023-11-07T05:31:56Z",
        "latencyMs": 123,
        "model": "<string>",
        "provider": "<string>",
        "promptTokens": 123,
        "completionTokens": 123,
        "cacheReadTokens": 123,
        "cacheWriteTokens": 123,
        "totalTokens": 123,
        "costUsd": 123,
        "costBreakdown": {},
        "costSource": "<string>",
        "status": "<string>",
        "attributes": {},
        "events": [
          {}
        ]
      },
      "children": "<array>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.idun-group.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
otel_trace_id
string
required

Response

Successful Response

Body of GET /admin/api/v1/traces/{otel_trace_id}.

tree holds the top-level spans of the trace. Orphan spans (those whose parent_span_id is not present in the same trace, e.g. truncated traces or cross-trace links) are also surfaced as roots so the UI never silently hides them.

​
trace
StandaloneTraceListItem · object
required

One row in GET /admin/api/v1/traces list response.

otel_trace_id is the lowercase hex encoding of the 16-byte W3C trace id. The DB stores raw bytes; routers convert at the boundary so JSON consumers never see a binary blob.

​
tree
StandaloneSpanTreeNode · object[]
Last modified on May 22, 2026