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>",
      "environment": "PROD",
      "isSuccess": true,
      "isCompleted": true,
      "metadata": {},
      "startedAt": "<string>",
      "endedAt": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "pageSize": 123
}
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