Skip to main content
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>",
      "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 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>[]
Available options:
spans,
annotations,
customMetrics

Response

Successfully retrieved traces matching the provided IDs

​
traces
object[]
required