Skip to main content
GET
/
api
/
v1
/
traces
/
{trace_id}
/
spans
Get trace spans
curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/traces/{trace_id}/spans \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "trace_id": "<string>",
    "span_id": "<string>",
    "organization_id": "<string>",
    "name": "<string>",
    "kind": "INTERNAL",
    "status_code": "UNSET",
    "start_time_unix_nano": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "parent_span_id": "<string>",
    "status_message": "<string>",
    "end_time_unix_nano": 123,
    "duration_ns": 123,
    "duration_ms": 123,
    "attributes": {},
    "resource_attributes": {},
    "events": [
      {}
    ],
    "links": [
      {}
    ],
    "children": "<array>"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt

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

Authorizations

​
Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Path Parameters

​
trace_id
string
required

Query Parameters

​
flat
boolean
default:false

Return spans as flat list instead of tree

Response

Successful Response

​
id
string
required
​
trace_id
string
required
​
span_id
string
required
​
organization_id
string
required
​
name
string
required
​
kind
enum<string>
required

OTEL span kind enum

Available options:
INTERNAL,
SERVER,
CLIENT,
PRODUCER,
CONSUMER
​
status_code
enum<string>
required

OTEL span status code enum

Available options:
UNSET,
OK,
ERROR
​
start_time_unix_nano
integer
required
​
created_at
string<date-time>
required
​
parent_span_id
string | null
​
status_message
string | null
​
end_time_unix_nano
integer | null
​
duration_ns
integer | null
​
duration_ms
number | null
​
attributes
Attributes · object
​
resource_attributes
Resource Attributes · object
​
events
Events · object[]
​
links
Links · object[]
​
children
Children · array