---
title: "Search Traces"
method: GET
path: "/v1/telemetry/traces"
tags: ["Dome", "Telemetry"]
---

# Search Traces

`GET /v1/telemetry/traces`

Search traces.

## Query parameters

- `time_range` '15m' | '30m' | '1h' | '2h' | '6h' | '1d' | '7d' | '30d' — Window to search for traces
- `limit` integer — Maximum number of traces to return
- `service_name` string, nullable — Filter by root service
- `agent_configuration_id` string, nullable — Filter by agent id
- `min_duration_ms` integer, nullable — Lower bound on trace duration (ms)
- `max_duration_ms` integer, nullable — Upper bound on trace duration (ms)
- `query` string, nullable — Advanced TraceQL query

## Response `200`

Successful Response

- TraceSearchResponse
  - `traces` TraceSummaryResponse[]
    - `trace_id` string, required — Hex encoded trace identifier
    - `root_service_name` string, nullable
    - `root_trace_name` string, nullable
    - `start_time_unix_nano` integer, nullable
    - `duration_ms` number, nullable
  - `metrics` TraceSearchMetricsResponse
    - `inspectedTraces` integer, nullable
    - `inspectedBytes` string, nullable
    - `completedJobs` integer, nullable
    - `totalJobs` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)