Returns unique trace IDs matching the given filters

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.

post/api/trace/ids

Request

Base URL: https://api.eu-west-1.aws.dash0.com
URL: https://api.eu-west-1.aws.dash0.com/api/trace/ids
Auth: none declared

Request body

datasetstring

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

Example request

{
  "filter": [
    {
      "key": "service.name",
      "operator": "is",
      "value": "foo"
    }
  ],
  "timeRange": {
    "from": "now-30m",
    "to": "now"
  },
  "sampling": {
    "timeRange": {
      "from": "now-30m",
      "to": "now"
    }
  },
  "pagination": {
    "limit": 10
  }
}

Response

Returns unique trace IDs as hex-encoded strings.

traceIdsstring[] required

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

Changes

No recorded changes to this operation across all 1 revision of this API.