Skip to main content
GET
/
api
/
v1
/
traces
/
{trace_id}
Get trace details
curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/traces/{trace_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "trace_id": "<string>",
  "organization_id": "<string>",
  "name": "<string>",
  "status": "success",
  "started_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "service_name": "<string>",
  "execution_id": "<string>",
  "execution_type": "<string>",
  "user_id": "<string>",
  "user_email": "<string>",
  "user_name": "<string>",
  "user_avatar": "<string>",
  "ended_at": "2023-11-07T05:31:56Z",
  "duration_ms": 123,
  "span_count": 0,
  "error_count": 0,
  "updated_at": "2023-11-07T05:31:56Z",
  "spans": [
    {
      "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

Detailed trace response with spans

​
id
string
required
​
trace_id
string
required
​
organization_id
string
required
​
name
string
required
​
status
enum<string>
required

Trace status enum

Available options:
success,
error,
running
​
started_at
string<date-time>
required
​
created_at
string<date-time>
required
​
service_name
string | null
​
execution_id
string | null
​
execution_type
string | null
​
user_id
string | null
​
user_email
string | null
​
user_name
string | null
​
user_avatar
string | null
​
ended_at
string<date-time> | null
​
duration_ms
integer | null
​
span_count
integer
default:0
​
error_count
integer
default:0
​
updated_at
string<date-time> | null
​
spans
SpanResponse · object[]