Get trace details - LangWatch

Python

import requests

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

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

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

print(response.text)

const options = {method: 'GET', headers: {'X-Auth-Token': '<api-key>'}};

fetch('https://app.langwatch.ai/api/v1/traces/{traceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "candidateTraceIds": [
    "<string>"
  ]
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

GET

api

traces

{traceId}

Python

import requests

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

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

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

print(response.text)

const options = {method: 'GET', headers: {'X-Auth-Token': '<api-key>'}};

fetch('https://app.langwatch.ai/api/v1/traces/{traceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "message": "<string>"
}

{
  "message": "<string>",
  "candidateTraceIds": [
    "<string>"
  ]
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<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.

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.

Minimum string length: 1

Query Parameters

format

string

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

llmMode

string

Deprecated: use format=digest instead

Response

Trace detail with spans, evaluations, and ASCII tree

{key}

any

Last modified on October 12, 2026