Skip to main content
POST
/
api
/
traces
/
search
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)
{
  "traces": [
    "<unknown>"
  ],
  "pagination": {
    "totalHits": 123,
    "scrollId": "<string>"
  }
}

Authorizations

X-Auth-Token
string
header
required

Body

application/json
startDate
required
endDate
required
query
string
filters
object
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
llmMode
boolean

Response

Matching traces with pagination

traces
any[]
required
pagination
object
required