---
title: "Changes to Get a trace"
method: GET
path: "/api/traces/{trace_unique_id}/"
---

# Changes to Get a trace

`GET /api/traces/{trace_unique_id}/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 19 revisions.

- **2026-10-21** `c30bcb383ee8`: 9 breaking, 4 info
- **2026-10-02** `b830b79cfd52`: 4 breaking, 2 info
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
- **2026-09-12** `22b868ef3f22`: 1 info
- **2026-08-13** `4e064cf81dae`: 32 info
- **2026-07-31** `c26d550029f8`: 30 warning, 4 info

## Changes

- **2026-10-21** `c30bcb383ee8`: 9 breaking, 4 info
  - the response property `input` became nullable for the status `200`
  - the response property `output` became nullable for the status `200`
  - the response property `span_tree/items/input` became nullable for the status `200`
  - the response property `span_tree/items/output` became nullable for the status `200`
  - the response property `span_tree/items/span_parent_id` became nullable for the status `200`
  - the `duration` response's property format changed from `double` to no format for status `200`
  - the `span_tree/items/cost` response's property format changed from `double` to no format for status `200`
  - the `span_tree/items/latency` response's property format changed from `double` to no format for status `200`
  - the `total_cost` response's property format changed from `double` to no format for status `200`
  - api operation id `traces_retrieveTrace` removed and replaced with `retrieveTrace`
  - the endpoint scheme security `DashboardJwt` was added to the API
  - api tag `Traces` added
  - api tag `traces` removed
- **2026-10-02** `b830b79cfd52`: 4 breaking, 2 info
  - the response property `input` became nullable for the status `200`
  - the response property `output` became nullable for the status `200`
  - the response property `span_tree/items/input` became nullable for the status `200`
  - the response property `span_tree/items/output` became nullable for the status `200`
  - added the non-success response with the status `403`
  - removed the non-success response with the status `401`
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `RespanApiKey` was added to the API
- **2026-09-12** `22b868ef3f22`: 1 info
  - api operation id `retrieve-trace` removed and replaced with `traces_retrieveTrace`
- **2026-08-13** `4e064cf81dae`: 32 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - added the optional property `customer_identifier` to the response with the `200` status
  - added the optional property `duration` to the response with the `200` status
  - added the optional property `end_time` to the response with the `200` status
  - added the optional property `environment` to the response with the `200` status
  - added the optional property `error_count` to the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the optional property `input` to the response with the `200` status
  - added the optional property `llm_call_count` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - added the optional property `model` to the response with the `200` status
  - added the optional property `name` to the response with the `200` status
  - added the optional property `organization_id` to the response with the `200` status
  - added the optional property `organization_key_id` to the response with the `200` status
  - added the optional property `organization_name` to the response with the `200` status
  - added the optional property `output` to the response with the `200` status
  - added the optional property `root_span_unique_id` to the response with the `200` status
  - added the optional property `session_identifier` to the response with the `200` status
  - added the optional property `span_count` to the response with the `200` status
  - added the optional property `span_tree` to the response with the `200` status
  - added the optional property `start_time` to the response with the `200` status
  - added the optional property `storage_object_key` to the response with the `200` status
  - added the optional property `total_completion_tokens` to the response with the `200` status
  - added the optional property `total_cost` to the response with the `200` status
  - added the optional property `total_prompt_tokens` to the response with the `200` status
  - added the optional property `total_tokens` to the response with the `200` status
  - added the optional property `trace_group_identifier` to the response with the `200` status
  - added the optional property `trace_unique_id` to the response with the `200` status
  - added the optional property `unique_organization_id` to the response with the `200` status
- **2026-07-31** `c26d550029f8`: 30 warning, 4 info
  - deleted the `query` request parameter `end_time`
  - deleted the `query` request parameter `start_time`
  - removed the optional property `customer_identifier` from the response with the `200` status
  - removed the optional property `duration` from the response with the `200` status
  - removed the optional property `end_time` from the response with the `200` status
  - removed the optional property `environment` from the response with the `200` status
  - removed the optional property `error_count` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `input` from the response with the `200` status
  - removed the optional property `llm_call_count` from the response with the `200` status
  - removed the optional property `metadata` from the response with the `200` status
  - removed the optional property `model` from the response with the `200` status
  - removed the optional property `name` from the response with the `200` status
  - removed the optional property `organization_id` from the response with the `200` status
  - removed the optional property `organization_key_id` from the response with the `200` status
  - removed the optional property `organization_name` from the response with the `200` status
  - removed the optional property `output` from the response with the `200` status
  - removed the optional property `root_span_unique_id` from the response with the `200` status
  - removed the optional property `session_identifier` from the response with the `200` status
  - removed the optional property `span_count` from the response with the `200` status
  - removed the optional property `span_tree` from the response with the `200` status
  - removed the optional property `start_time` from the response with the `200` status
  - removed the optional property `storage_object_key` from the response with the `200` status
  - removed the optional property `total_completion_tokens` from the response with the `200` status
  - removed the optional property `total_cost` from the response with the `200` status
  - removed the optional property `total_prompt_tokens` from the response with the `200` status
  - removed the optional property `total_tokens` from the response with the `200` status
  - removed the optional property `trace_group_identifier` from the response with the `200` status
  - removed the optional property `trace_unique_id` from the response with the `200` status
  - removed the optional property `unique_organization_id` from the response with the `200` status
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`

---

[Operation](https://skmtc.dev/keywordsai/apis/respan-api/docs/api/traces/:trace_unique_id/get.md) - [API](https://skmtc.dev/keywordsai/apis/respan-api.md) - [Page](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/traces/:trace_unique_id/get)
