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>"
        }
      }
    ]
  }
}
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