Retrieve a trace

Fetch a single trace record by request_id. When the trace has a payload_url, follow it to download the full payload archive — the URL is short-lived and signed; refetch the trace to mint a fresh one.

GET /v1/traces/{request_id} Preview

https://api.routeur.ai

Path parameters

request_id string required

Trace request id, e.g. 01K.... Returned from the routeur block of any chat response.

Returns

The matching Trace object, or 404 not_found.

← List traces Inspect trace →

curl https://api.routeur.ai/v1/traces/01K... \
  -H "Authorization: Bearer $ROUTEUR_KEY"

const res = await fetch(
  `https://api.routeur.ai/v1/traces/${requestId}`,
  { headers: { Authorization: `Bearer ${process.env.ROUTEUR_KEY}` } }
);
const trace = await res.json();

r = requests.get(
    f"https://api.routeur.ai/v1/traces/{request_id}",
    headers={"Authorization": f"Bearer {os.environ['ROUTEUR_KEY']}"},
)
trace = r.json()

200 application/json

Response

{
  "request_id":  "01K...",
  "provider":    "openai",
  "model":       "gpt-4o-mini",
  "latency_ms":  2939,
  "status_code": 200,
  "cost_usd":    0.00000615,
  "redactions":  1,
  "payload_url": "https://payloads.routeur.ai/...?sig=..."
}