Skip to content
Overmind
Get started
API Reference
Traces

List traces (root spans)

GET/api/traces/

Returns one row per trace — the root span (parent_span_id IS NULL) of each trace the caller can see.

Query ParametersExpand Collapse
agent: optional string
formatuuid
duration_ns__gte: optional number
duration_ns__lte: optional number
has_error: optional boolean
iteration: optional string
formatuuid
job: optional string
formatuuid
kind: optional number
max_duration_ms: optional number
min_duration_ms: optional number
name: optional string
operation: optional string
ordering: optional string

Which field to use when ordering the results.

page: optional number

A page number within the paginated result set.

project: optional string
formatuuid
received_at__gte: optional string
formatdate-time
received_at__lte: optional string
formatdate-time
service_name: optional string
service_name__in: optional array of string

Multiple values may be separated by commas.

span_id: optional string
span_type: optional "llm_call" or "tool_call"
  • llm_call - Llm Call
  • tool_call - Tool Call
Accepts one of the following:
"llm_call"
"tool_call"
start_time_ns__gte: optional number
start_time_ns__lte: optional number
status_code: optional number
trace_id: optional string
ReturnsExpand Collapse
count: number
results: array of object { agent, duration_ns, end_time_ns, 14 more }
agent: string
formatuuid
duration_ns: number
end_time_ns: number
iteration: string
formatuuid
job: string
formatuuid
kind: number
name: string
operation: string
project: string
formatuuid
received_at: string
formatdate-time
service_name: string
span_id: string
span_type: "llm_call" or "tool_call"
  • llm_call - Llm Call
  • tool_call - Tool Call
Accepts one of the following:
"llm_call"
"tool_call"
start_time_ns: number
status_code: number
status_message: string
trace_id: string
List traces (root spans)
curl https://api.overmindlab.ai/api/traces/
{
  "count": 123,
  "results": [
    {
      "agent": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "duration_ns": 0,
      "end_time_ns": 0,
      "iteration": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "job": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "kind": 0,
      "name": "name",
      "operation": "operation",
      "project": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "received_at": "2019-12-27T18:11:19.117Z",
      "service_name": "service_name",
      "span_id": "span_id",
      "span_type": "llm_call",
      "start_time_ns": 0,
      "status_code": 0,
      "status_message": "status_message",
      "trace_id": "trace_id"
    }
  ],
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}
Returns Examples
{
  "count": 123,
  "results": [
    {
      "agent": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "duration_ns": 0,
      "end_time_ns": 0,
      "iteration": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "job": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "kind": 0,
      "name": "name",
      "operation": "operation",
      "project": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "received_at": "2019-12-27T18:11:19.117Z",
      "service_name": "service_name",
      "span_id": "span_id",
      "span_type": "llm_call",
      "start_time_ns": 0,
      "status_code": 0,
      "status_message": "status_message",
      "trace_id": "trace_id"
    }
  ],
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}