> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "List traces"
description: "List distributed traces recorded for a workspace, optionally scoped to a single deployment."
method: "GET"
endpoint: "/api/v1/traces"
order: 4
last_verified: 2026-07-27
---



`GET /api/v1/traces`

List distributed traces recorded for a workspace, optionally scoped to a single deployment.


  ### Query parameters

  - `workspace_id` _string_ **required** — The workspace's UUID. Required.
  - `deployment_id` _string_ — Restrict to a single deployment.
  - `service` _string_ — Filter to a single service name.
  - `since` _string_ — Start of the time range, as nanoseconds or RFC 3339. Defaults to 24 hours ago.
  - `until` _string_ — End of the time range, as nanoseconds or RFC 3339. Defaults to now.
  - `min_duration_ms` _integer_ — Only return traces at least this long.
  - `limit` _integer_ — Maximum traces to return. Defaults to 100.



  ### Response

  ```json {{ title: 'Response' }}
  {
    "items": [
      {
        "trace_id": "4f6a2e1b8c9d7f3a5e2b1c4d6a8f9e0b",
        "start_ns": 1753612801123000000,
        "end_ns": 1753612805123000000,
        "duration_ms": 4000,
        "span_count": 12
      }
    ],
    "count": 1,
    "next_offset": 0
  }
  ```