Search Traces

Returns a cursor-paginated page of filtered trace rows for a project. Pass nextCursor from the response as cursor to fetch the next page.

POST /logs/traces

Search traces

cURL

curl --request POST \
  --url https://api.adaline.ai/v2/logs/traces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "startedAfter": 123,
  "startedBefore": 123,
  "name": "<string>",
  "referenceId": "<string>",
  "sessionId": "<string>",
  "filters": [
    {
      "column": "<string>",
      "operator": "<string>",
      "value": "<unknown>"
    }
  ],
  "limit": 100,
  "cursor": "<string>"
}
'

200

{
  "pagination": {
    "limit": 123,
    "returned": 1,
    "hasMore": true,
    "nextCursor": "<string>"
  },
  "traces": [
    {
      "id": "<string>",
      "name": "<string>",
      "startedAt": 17450965800000,
      "endedAt": 17450965800000,
      "latency": 123,
      "referenceId": "<string>",
      "sessionId": "<string>",
      "attributes": {},
      "tags": [
        "<string>"
      ],
      "totalCost": 123,
      "totalInputTokens": 123,
      "totalOutputTokens": 123,
      "spanIds": [
        "<string>"
      ],
      "createdAt": 17450965800000,
      "updatedAt": 17450965800000
    }
  ]
}

Returns a cursor-paginated page of filtered trace rows. Pass nextCursor from the response as cursor to fetch the next page.

See Export Logs for filter types, available columns, and pagination conventions.

Authorizations

Authorization · string · header · required

Workspace API key. Pass as Authorization: Bearer <key>.

Body

application/json

Request payload for paginated trace search.

projectId · string · required

The project to search traces in.

Required string length: 20 - 80

startedAfter · integer

Unix timestamp in milliseconds. Only return rows started at or after this time.

startedBefore · integer

Unix timestamp in milliseconds. Only return rows started at or before this time.

status · enum<string>

Filter by status.

Available options: success, failure, aborted, cancelled, pending, unknown

name · string

Case-insensitive substring match on the trace or span name.

referenceId · string

Exact match on the reference ID.

sessionId · string

Exact match on the session ID.

filters · Log Filter Object · object[]

Typed filter objects for advanced queries. ANDed with flat params.

Maximum array length: 20

Show child attributes

sort · enum<string>

Sort order. Defaults to startedAt:desc.

Available options: startedAt:asc, startedAt:desc

limit · integer

Page size. Defaults to 50, max 200.

Required range: 1 <= x <= 200

cursor · string

Opaque pagination cursor from a previous response.

Response

200

application/json

A page of search results with cursor-based pagination metadata.

Paginated search results for log traces.

pagination · Pagination · object · required

Pagination metadata for list endpoints with cursor-based navigation.

Show child attributes

traces · Log Trace Item · object[] · required

Array of log trace items.

Show child attributes