Skip to main content
POST
Python

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
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
includeSpans
boolean

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

llmMode
boolean

Response

Matching traces with pagination

traces
any[]
required
pagination
object
required