API reference · Recorder
List your traces
GET/api/tracesSigned in session
Metadata only: model, upstream, attempts, timings, tokens, cost, and whether a body was captured. Bodies live behind GET /api/traces/{traceId}.
Parameters
| Field | Type | What it is |
|---|---|---|
| limit (query) | integer | Default 25. From 1 to 100. |
| before (query) | integer | Continue from a previous nextBefore. |
| model (query) | string | Filter by model id. |
| failed (query) | string | Only traces that failed. One of "1". |
Answer 200
Your traces, newest first.
| Field | Type | What it is |
|---|---|---|
| traces | array of TraceSummary | |
| traces[] | string | 32 hex characters. |
| traces[] | integer | |
| traces[] | integer | |
| traces[] | string or null | |
| traces[] | string or null | |
| traces[] | integer or null | |
| traces[] | integer | Upstream attempts behind this one client request. |
| traces[] | integer or null | |
| traces[] | integer | |
| traces[] | integer | Micro USD, integer end to end. |
| traces[] | boolean | True when the request and response bodies were stored. |
| traces[] | string or null | |
| nextBefore | integer or null |
Errors
- 401OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.