Skip to main content
GET
/
api
/
sdk
/
v1
/
traces
/
{traceId}
Get a single trace by ID
curl --request GET \
  --url https://app.atla-ai.com/api/sdk/v1/traces/{traceId} \
  --header 'Authorization: Bearer <token>'
{
  "trace": {
    "id": "<string>",
    "isSuccess": true,
    "isCompleted": true,
    "stepCount": 123,
    "startedAt": "<string>",
    "endedAt": "<string>",
    "durationSeconds": 123,
    "ingestedAt": "<string>",
    "metadata": {},
    "spans": [
      {
        "id": "<string>",
        "traceId": "<string>",
        "parentSpanId": "<string>",
        "spanName": "<string>",
        "startTimestamp": "<string>",
        "endTimestamp": "<string>",
        "isException": true,
        "otelEvents": [
          "<unknown>"
        ],
        "annotations": [
          {
            "spanId": "<string>",
            "failureMode": "<string>",
            "atlaCritique": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "customMetricValues": [
      {
        "id": "<string>",
        "traceId": "<string>",
        "customMetricId": "<string>",
        "value": "<string>",
        "customMetric": {
          "id": "<string>",
          "name": "<string>"
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.atla-ai.com/llms.txt

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

Retrieve a specific trace by its unique identifier. Returns complete trace data including all spans, annotations, trace summary, and custom metric values.

Authorizations

Authorization
string
header
required

API key authentication using Bearer token

Path Parameters

traceId
string
required

Query Parameters

include
enum<string>[]
Available options:
spans,
annotations,
customMetrics

Response

Successfully retrieved trace with complete data

trace
object
required