Get trace details

Get a single trace by ID.

GET /api/traces/{traceId}

Python

Python

import requests

url = "https://app.langwatch.ai/api/traces/{traceId}"

headers = {"X-Auth-Token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{}

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.

Path Parameters

traceId · string · required

The trace ID — either the full 32-char ID or a unique prefix (≥ 8 chars). Prefix lookup is scoped to the authenticated project.

Query Parameters

format · enum<string>

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

Available options: digest, json

llmMode · enum<string>

Deprecated: use format=digest instead

Available options: true, false, 1, 0

Response

200

application/json

Trace detail with spans, evaluations, and ASCII tree

The response is of type object.