Query Telemetry

Returns unique trace IDs matching the given filters

post/api/trace/ids

Lightweight endpoint that returns only the unique trace IDs of traces containing at least one span matching the request filters. Useful for two-step workflows: first find matching trace IDs, then fetch full trace details via GetTrace (POST /api/trace/details). Significantly faster and lighter-weight than GetSpans (POST /api/spans) when only trace IDs are needed.

bash

Sample request12345678910111213141516
curl --request POST 'https://api.eu-west-1.aws.dash0.com/api/trace/ids' \
  --header "Authorization: Bearer ${DASH0_AUTH_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "timeRange": {
    "from": "now-10m",
    "to": "now"
  },
  "filter": [
    {
      "key": "service.name",
      "operator": "is",
      "value": "shop"
    }
  ]
}'

Server

Request body required

References GetTraceIdsRequest

Request to retrieve unique trace IDs of traces that contain at least one span matching the given filters. This is a lightweight alternative to GetSpans for two-step workflows where only trace IDs are needed first, and full trace details are subsequently retrieved via GetTrace (POST /api/trace/details).

FilterCriteria

TimeReferenceRangerequired

A range of time between two time references.

Dataset

Optional dataset to query across. Defaults to whatever is configured to be the default dataset for the organization.

Sampling

OrderingCriteria

The ordering criteria for the returned trace IDs. Only otel.trace.start_time descending is supported (this is also the default when omitted). Any other key, ascending direction, or multiple criteria will be rejected with a 400 response. A trace's start time is the timestamp of its earliest matching span; trace IDs are returned ordered by that value.

CursorPagination

Cursor pagination for trace IDs.

Maximum and default limit: 5000 elements per page
Multiple pages may be required to retrieve all matching trace IDs

Responses

Returns unique trace IDs as hex-encoded strings.

References GetTraceIdsResponse

Response for the GetTraceIds API. Contains an array of unique trace IDs that match the request filters, ordered by the timestamp of their earliest matching span (descending).

string[]required

Array of unique trace IDs as hex-encoded strings, ordered by the timestamp of each trace's earliest matching span (descending).

NextCursors

The cursors for the next sets of results. This property is included to support pagination through the result set when additional pages are available.