Search traces

Search traces for a project

POST /api/traces/search

Python

Python

import requests

url = "https://app.langwatch.ai/api/traces/search"

payload = {
    "startDate": 123,
    "endDate": 123
}
headers = {
    "X-Auth-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "traces": [
    "<unknown>"
  ],
  "pagination": {
    "totalHits": 123,
    "scrollId": "<string>"
  }
}

Authorizations

X-Auth-Token · string · header · required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Body

application/json

startDate · number string · required

endDate · number string · required

query · string

filters · object

Show child attributes

traceIds · string[]

negateFilters · boolean

pageOffset · number

pageSize · number

groupBy · string

sortBy · string

sortDirection · string

updatedAt · number

scrollId · string | null

format · enum<string>

Output format: 'digest' (AI-readable trace digest) or 'json' (full raw data)

Available options: digest, json

includeSpans · boolean

When true, fetches full span data for each trace. Useful for bulk export. Default false.

llmMode · boolean

Response

200

application/json

Matching traces with pagination

traces · any[] · required

pagination · object · required

Show child attributes