Returns unique trace IDs matching the given filters.

post

https://api.eu-west-1.aws.dash0.com/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

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).

filter

array of objects

filter

timeRange

object

required

A range of time between two time references.

dataset

string

^[a-zA-Z0-9_-]{3,26}$

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

sampling

object

ordering

array of objects

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.

ordering

pagination

object

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

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Returns unique trace IDs as hex-encoded strings.

defaultIn case any error happens.