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>",
    "environment": "PROD",
    "isSuccess": true,
    "isCompleted": true,
    "metadata": {},
    "stepCount": 123,
    "startedAt": "<string>",
    "endedAt": "<string>",
    "durationSeconds": 123,
    "ingestedAt": "<string>",
    "spans": [
      {
        "id": "<string>",
        "traceId": "<string>",
        "parentSpanId": "<string>",
        "spanName": "<string>",
        "startTimestamp": "<string>",
        "endTimestamp": "<string>",
        "isException": true,
        "otelEvents": [
          "<any>"
        ],
        "annotations": [
          {
            "spanId": "<string>",
            "failureMode": "<string>",
            "atlaCritique": "<string>",
            "id": "<string>"
          }
        ]
      }
    ],
    "customMetricValues": [
      {
        "id": "<string>",
        "traceId": "<string>",
        "customMetricId": "<string>",
        "value": "<string>",
        "customMetric": {
          "id": "<string>",
          "name": "<string>",
          "dataType": "BOOLEAN"
        }
      }
    ]
  }
}
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>[]

Response

200
application/json

Successfully retrieved trace with complete data

The response is of type object.