---
title: "Changes to List traces"
method: POST
path: "/api/traces/list/"
---

# Changes to List traces

`POST /api/traces/list/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2026-10-21** `c30bcb383ee8`: 5 breaking, 4 info
- **2026-10-02** `b830b79cfd52`: 46 breaking, 5 warning, 142 info
- **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info
- **2026-09-12** `22b868ef3f22`: 1 info
- **2026-08-22** `b18c72975097`: 1 warning
- **2026-08-13** `4e064cf81dae`: 1 breaking, 27 warning, 13 info
- **2026-07-31** `c26d550029f8`: 3 breaking, 7 warning, 30 info

## Changes

- **2026-10-21** `c30bcb383ee8`: 5 breaking, 4 info
  - request body became required
  - the response property `next` became nullable for the status `200`
  - the response property `previous` became nullable for the status `200`
  - the `results/items/duration` response's property format changed from `double` to no format for status `200`
  - the `results/items/total_cost` response's property format changed from `double` to no format for status `200`
  - api operation id `traces_listTraces` removed and replaced with `listTraces`
  - the endpoint scheme security `DashboardJwt` was added to the API
  - api tag `Traces` added
  - api tag `traces` removed
- **2026-10-02** `b830b79cfd52`: 46 breaking, 5 warning, 142 info
  - removed the enum value `iexact` of the request property `filters/cache_key/operator`
  - removed the enum value `iexact` of the request property `filters/completion_tokens/operator`
  - removed the enum value `iexact` of the request property `filters/cost/operator`
  - removed the enum value `iexact` of the request property `filters/custom_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/customer_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/group_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/is_root_span/operator`
  - removed the enum value `iexact` of the request property `filters/latency/operator`
  - removed the enum value `iexact` of the request property `filters/log_type/operator`
  - removed the enum value `iexact` of the request property `filters/model/operator`
  - removed the enum value `iexact` of the request property `filters/positive_feedback/operator`
  - removed the enum value `iexact` of the request property `filters/prompt_id/operator`
  - removed the enum value `iexact` of the request property `filters/prompt_tokens/operator`
  - removed the enum value `iexact` of the request property `filters/span_name/operator`
  - removed the enum value `iexact` of the request property `filters/span_parent_id/operator`
  - removed the enum value `iexact` of the request property `filters/span_workflow_name/operator`
  - removed the enum value `iexact` of the request property `filters/status/operator`
  - removed the enum value `iexact` of the request property `filters/status_code/operator`
  - removed the enum value `iexact` of the request property `filters/stream/operator`
  - removed the enum value `iexact` of the request property `filters/thread_identifier/operator`
  - removed the enum value `iexact` of the request property `filters/total_tokens/operator`
  - removed the enum value `iexact` of the request property `filters/trace_unique_id/operator`
  - removed the enum value `iexact` of the request property `filters/unique_id/operator`
  - removed the enum value `isnull` of the request property `filters/cache_key/operator`
  - removed the enum value `isnull` of the request property `filters/completion_tokens/operator`
  - removed the enum value `isnull` of the request property `filters/cost/operator`
  - removed the enum value `isnull` of the request property `filters/custom_identifier/operator`
  - removed the enum value `isnull` of the request property `filters/customer_identifier/operator`
  - removed the enum value `isnull` of the request property `filters/group_identifier/operator`
  - removed the enum value `isnull` of the request property `filters/is_root_span/operator`
  - removed the enum value `isnull` of the request property `filters/latency/operator`
  - removed the enum value `isnull` of the request property `filters/log_type/operator`
  - removed the enum value `isnull` of the request property `filters/model/operator`
  - removed the enum value `isnull` of the request property `filters/positive_feedback/operator`
  - removed the enum value `isnull` of the request property `filters/prompt_id/operator`
  - removed the enum value `isnull` of the request property `filters/prompt_tokens/operator`
  - removed the enum value `isnull` of the request property `filters/span_name/operator`
  - removed the enum value `isnull` of the request property `filters/span_parent_id/operator`
  - removed the enum value `isnull` of the request property `filters/span_workflow_name/operator`
  - removed the enum value `isnull` of the request property `filters/status/operator`
  - …153 more
- **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 `list-traces` removed and replaced with `traces_listTraces`
- **2026-08-22** `b18c72975097`: 1 warning
  - for the `query` request parameter `page_size`, the max was set to `1000.00`
- **2026-08-13** `4e064cf81dae`: 1 breaking, 27 warning, 13 info
  - removed the success response with the status `201`
  - removed the request property `customer_identifier`
  - removed the request property `duration`
  - removed the request property `end_time`
  - removed the request property `environment`
  - removed the request property `error_count`
  - removed the request property `id`
  - removed the request property `input`
  - removed the request property `llm_call_count`
  - removed the request property `metadata`
  - removed the request property `model`
  - removed the request property `name`
  - removed the request property `organization_id`
  - removed the request property `organization_key_id`
  - removed the request property `organization_name`
  - removed the request property `output`
  - removed the request property `root_span_unique_id`
  - removed the request property `session_identifier`
  - removed the request property `span_count`
  - removed the request property `start_time`
  - removed the request property `storage_object_key`
  - removed the request property `total_completion_tokens`
  - removed the request property `total_cost`
  - removed the request property `total_prompt_tokens`
  - removed the request property `total_tokens`
  - removed the request property `trace_group_identifier`
  - removed the request property `trace_unique_id`
  - removed the request property `unique_organization_id`
  - added the new optional `query` request parameter `end_time`
  - added the new optional `query` request parameter `environment`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `page_size`
  - added the new optional `query` request parameter `sort_by`
  - added the new optional `query` request parameter `start_time`
  - added the new optional request property `filters`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `413`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - …1 more
- **2026-07-31** `c26d550029f8`: 3 breaking, 7 warning, 30 info
  - added the new required request property `id`
  - added the new required request property `trace_unique_id`
  - removed the success response with the status `200`
  - deleted the `query` request parameter `end_time`
  - deleted the `query` request parameter `environment`
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `page_size`
  - deleted the `query` request parameter `sort_by`
  - deleted the `query` request parameter `start_time`
  - removed the request property `filters`
  - added the new optional request property `customer_identifier`
  - added the new optional request property `duration`
  - added the new optional request property `end_time`
  - added the new optional request property `environment`
  - added the new optional request property `error_count`
  - added the new optional request property `input`
  - added the new optional request property `llm_call_count`
  - added the new optional request property `metadata`
  - added the new optional request property `model`
  - added the new optional request property `name`
  - added the new optional request property `organization_id`
  - added the new optional request property `organization_key_id`
  - added the new optional request property `organization_name`
  - added the new optional request property `output`
  - added the new optional request property `root_span_unique_id`
  - added the new optional request property `session_identifier`
  - added the new optional request property `span_count`
  - added the new optional request property `start_time`
  - added the new optional request property `storage_object_key`
  - added the new optional request property `total_completion_tokens`
  - added the new optional request property `total_cost`
  - added the new optional request property `total_prompt_tokens`
  - added the new optional request property `total_tokens`
  - added the new optional request property `trace_group_identifier`
  - added the new optional request property `unique_organization_id`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`
  - added the success response with the status `201`

---

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