Skip to main content
GET
/
api
/
sdk
/
v1
/
traces
List traces with pagination and filtering
curl --request GET \
  --url https://app.atla-ai.com/api/sdk/v1/traces \
  --header 'Authorization: Bearer <token>'
{
  "traces": [
    {
      "id": "<string>",
      "isSuccess": true,
      "isCompleted": true,
      "startedAt": "<string>",
      "endedAt": "<string>",
      "metadata": {}
    }
  ],
  "total": 123,
  "page": 123,
  "pageSize": 123
}

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

​
startTimestamp
string<date-time>
​
endTimestamp
string<date-time>
​
metadataFilter
string

URL-encoded JSON array of metadata key-value pairs: [{"key":"version","value":"1"}]

​
page
integer
default:1
Required range: x >= 1
​
pageSize
integer
default:50
Required range: 1 <= x <= 1000

Response

Successfully retrieved paginated list of traces

​
traces
object[]
required
​
total
number
required
​
page
integer
required
​
pageSize
integer
required