Skip to main content
POST
/
engine
/
query
Query Traces Spans
curl --request POST \
  --url https://engine-api.unomiq.com/engine/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Unomiq-App-Id: <x-unomiq-app-id>' \
  --data '
{
  "filter": {
    "and": [
      {
        "field": "span_attributes.http.status_code",
        "op": "gte",
        "value": "200"
      },
      {
        "field": "span_attributes.http.status_code",
        "op": "lte",
        "value": "299"
      },
      {
        "or": [
          {
            "field": "span_kind",
            "op": "eq",
            "value": "SERVER"
          },
          {
            "field": "span_kind",
            "op": "eq",
            "value": "CLIENT"
          }
        ]
      }
    ]
  }
}
'
{
  "data": [
    {
      "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>"
      }
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123
}

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

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"

​
page
integer
default:1

Page number for pagination (1-indexed)

Required range: x >= 1
​
limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100

Body

application/json

Request model for query filter.

​
filter
Condition · object

A single filter condition.

Example:
{
  "and": [
    {
      "field": "span_attributes.http.status_code",
      "op": "gte",
      "value": "200"
    },
    {
      "field": "span_attributes.http.status_code",
      "op": "lte",
      "value": "299"
    },
    {
      "or": [
        {
          "field": "span_kind",
          "op": "eq",
          "value": "SERVER"
        },
        {
          "field": "span_kind",
          "op": "eq",
          "value": "CLIENT"
        }
      ]
    }
  ]
}

Response

Successful Response

Response model for query operation.

​
data
Trace · object[]
required
​
total
integer
required
​
page
integer
required
​
limit
integer
required