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

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 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