Get Trace

Get details for a specific trace or a span within a time range.

Requires a valid JWT token with the read:traces permission.

The search is limited to spans where span_start_time falls within the specified time range. If span_id is provided, returns only the data for that specific span as a single-element list.

GET /traces/{trace_id}

Get Trace

cURL

curl --request GET \
  --url https://engine-api.unomiq.com/traces/{trace_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Unomiq-App-Id: <x-unomiq-app-id>'

200

[
  {
    "trace_id": "<string>",
    "span_id": "<string>",
    "span_start_time_unix_nano": 123,
    "span_end_time_unix_nano": 123,
    "duration_ms": 123,
    "span_name": "<string>",
    "span_kind": "<string>",
    "parent_span_id": "<string>",
    "service_name": "<string>",
    "unit": "<string>",
    "resource_attributes": {},
    "span_attributes": {},
    "cost": 123,
    "billing": {
      "resource_type": "<string>",
      "resource_name": "<string>",
      "service_id": "<string>",
      "service_name": "<string>",
      "sku_id": "<string>",
      "sku_name": "<string>",
      "region": "<string>"
    },
    "usage": {
      "amount": 123,
      "unit": "<string>"
    }
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Unomiq-App-Id · string · required

Path Parameters

trace_id · string · required

OpenTelemetry trace identifier (32-character hexadecimal string)

Example:

"4bf92f3577b34da6a3ce929d0e0e4736"

Query Parameters

start_time · string<date-time> · required

Start datetime (inclusive)

Example:

"2025-01-15T00:00:00Z"

end_time · string<date-time> · required

End datetime (exclusive)

Example:

"2025-01-16T00:00:00Z"

span_id · string | null

OpenTelemetry span identifier (16-character hexadecimal string). If provided, returns only the data for this specific span.

Example:

"5ab41c652fedc2af"

Response

200

application/json

Successful Response

trace_id · string · required

span_id · string · required

span_start_time_unix_nano · integer · required

span_end_time_unix_nano · integer · required

duration_ms · number · required

span_name · string · required

span_kind · string · required

parent_span_id · string | null

service_name · string | null

unit · string | null

resource_attributes · Resource Attributes · object

span_attributes · Span Attributes · object

cost · number | null

billing · BillingInfo · object

Billing information associated with a span.

Show child attributes

usage · UsageInfo · object

Usage information associated with a span.

Show child attributes