Skip to main content
POST
/
telemetry
/
get_traces
List or get traces
curl --request POST \
  --url https://api.svantic.com/telemetry/get_traces \
  --header 'Content-Type: application/json' \
  --data '
{
  "trace_id": "string",
  "page": 1,
  "page_size": 25,
  "session_id": "string",
  "status": "string",
  "has_plan": true
}
'
{
  "ok": true,
  "count": 0,
  "page": 0,
  "page_size": 0,
  "traces": [
    {
      "trace_id": "string",
      "session_id": "string",
      "tenant_id": "string",
      "root_agent": "string",
      "status": "string",
      "started_at": "2026-03-31T12:00:00.000Z",
      "ended_at": "2026-03-31T12:00:00.000Z",
      "duration_ms": 0,
      "span_count": 0
    }
  ],
  "trace": {
    "example_key": "example_value"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.svantic.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
trace_id
string

Fetch a single trace by ID (overrides list mode).

​
page
integer
default:1
Required range: x >= 1
​
page_size
integer
default:25
Required range: 1 <= x <= 100
​
session_id
string

Filter by session.

​
status
string

Filter by trace status.

​
has_plan
boolean

Filter to traces with embedded plans.

Response

Trace list or single trace detail.

​
ok
boolean
required
​
count
integer

Total matching traces (list mode).

​
page
integer
​
page_size
integer
​
traces
object[]

Present in list mode.

​
trace
object

Full trace with spans (single-trace mode).