---
title: "Changes to List Traces Route"
method: GET
path: "/api/v1/traces"
---

# Changes to List Traces Route

`GET /api/v1/traces`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 20 revisions.

- **2026-10-26** `3e25bef24f8f`: 9 info
- **2026-10-08** `1882866431ad`: 2 info
- **2026-10-04** `b475b750a0b7`: 5 info
- **2026-10-04** `2f4b4b338b8f`: 5 info
- **2026-09-27** `b20a3bdd6219`: 1 breaking, 1 warning, 2 info
- **2026-09-22** `66575c8854c1`: 1 warning
- **2026-08-31** `18ce94490752`: 1 info
- **2026-08-27** `9efbf54a37d4`: 1 info
- **2026-08-25** `e63bfe8e38b4`: 1 breaking

## Changes

- **2026-10-26** `3e25bef24f8f`: 9 info
  - added the optional property `items/items/agent_depth` to the response with the `200` status
  - added the optional property `items/items/caller_agent` to the response with the `200` status
  - added the optional property `items/items/caller_agent_id` to the response with the `200` status
  - added the optional property `items/items/caller_sub_agent` to the response with the `200` status
  - added the optional property `items/items/governance_latency_ms` to the response with the `200` status
  - added the optional property `items/items/model_ended_at` to the response with the `200` status
  - added the optional property `items/items/model_latency_ms` to the response with the `200` status
  - added the optional property `items/items/model_started_at` to the response with the `200` status
  - added the optional property `items/items/sub_agent` to the response with the `200` status
- **2026-10-08** `1882866431ad`: 2 info
  - added the optional property `items/items/matched_capability` to the response with the `200` status
  - added the optional property `items/items/matched_capability_id` to the response with the `200` status
- **2026-10-04** `b475b750a0b7`: 5 info
  - added the optional property `items/items/fallback_reason` to the response with the `200` status
  - added the optional property `items/items/primary_provider_id` to the response with the `200` status
  - added the optional property `items/items/provider_id` to the response with the `200` status
  - added the optional property `items/items/route_attempt` to the response with the `200` status
  - added the optional property `items/items/route_is_fallback` to the response with the `200` status
- **2026-10-04** `2f4b4b338b8f`: 5 info
  - added the optional property `items/items/config_sha256` to the response with the `200` status
  - added the optional property `items/items/config_version` to the response with the `200` status
  - added the optional property `items/items/policy_id` to the response with the `200` status
  - added the optional property `items/items/policy_version` to the response with the `200` status
  - added the optional property `items/items/provenance` to the response with the `200` status
- **2026-09-27** `b20a3bdd6219`: 1 breaking, 1 warning, 2 info
  - removed the required property `items/items/proxy_id` from the response with the `200` status
  - deleted the `query` request parameter `proxy_id`
  - added the new optional `query` request parameter `agent_id`
  - added the required property `items/items/agent_id` to the response with the `200` status
- **2026-09-22** `66575c8854c1`: 1 warning
  - removed the optional property `items/items/matched_capability` from the response with the `200` status
- **2026-08-31** `18ce94490752`: 1 info
  - added the optional property `items/items/source_deployment_id` to the response with the `200` status
- **2026-08-27** `9efbf54a37d4`: 1 info
  - endpoint added
- **2026-08-25** `e63bfe8e38b4`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/xenovia/apis/controlplane/docs/api/v1/traces/get.md) - [API](https://skmtc.dev/xenovia/apis/controlplane.md) - [Page](https://skmtc.dev/xenovia/apis/controlplane/changes/api/v1/traces/get)