GET
/
api
/
sdk
/
v1
/
traces
/
ids
Get multiple traces by IDs
curl --request GET \
  --url https://app.atla-ai.com/api/sdk/v1/traces/ids \
  --header 'Authorization: Bearer <token>'
{
  "traces": [
    {
      "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 specific traces by providing an array of trace IDs. Returns complete trace data including spans, summaries, and custom metrics for all found traces.

Authorizations

Authorization
string
header
required

API key authentication using Bearer token

Query Parameters

ids
string[]
required
include
enum<string>[]

Response

200
application/json

Successfully retrieved traces matching the provided IDs

The response is of type object.