---
title: "Changes to Get spans by project_name or project_id and optionally by trace_id and/or type"
method: GET
path: "/v1/private/spans"
---

# Changes to Get spans by project_name or project_id and optionally by trace_id and/or type

`GET /v1/private/spans`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 57 revisions.

- **2026-07-02** `3144ea40dac0` — 1 warning
- **2026-06-30** `20a1a33446d1` — 2 info
- **2026-06-19** `580e3bc69e8a` — 2 info
- **2026-05-08** `b9100cf75dd3` — 1 info
- **2026-05-04** `d606e84c75e4` — 5 warning, 1 info

## Changes

- **2026-07-02** `3144ea40dac0` — 1 warning
  - added the new `evaluator` enum value to the `content/items/source` response property for the response status `200`
- **2026-06-30** `20a1a33446d1` — 2 info
  - added the optional property `content/items/feedback_scores/items/value_by_author/additionalProperties/author` to the response with the `200` status
  - added the optional property `content/items/feedback_scores/items/value_by_author/additionalProperties/source_queue_id` to the response with the `200` status
- **2026-06-19** `580e3bc69e8a` — 2 info
  - added the optional property `content/items/comments/items/source_queue_id` to the response with the `200` status
  - added the optional property `content/items/feedback_scores/items/source_queue_id` to the response with the `200` status
- **2026-05-08** `b9100cf75dd3` — 1 info
  - added the optional property `content/items/environment` to the response with the `200` status
- **2026-05-04** `d606e84c75e4` — 5 warning, 1 info
  - removed the optional property `content/items/comments/items/source_queue_id` from the response with the `200` status
  - removed the optional property `content/items/environment` from the response with the `200` status
  - removed the optional property `content/items/feedback_scores/items/source_queue_id` from the response with the `200` status
  - removed the optional property `content/items/feedback_scores/items/value_by_author/additionalProperties/author` from the response with the `200` status
  - removed the optional property `content/items/feedback_scores/items/value_by_author/additionalProperties/source_queue_id` from the response with the `200` status
  - removed the `evaluator` enum value from the `content/items/source` response property for the response status `200`

---

[Operation](https://skmtc.dev/comet-ml/apis/opik-rest-api/docs/v1/private/spans/get.md) · [API](https://skmtc.dev/comet-ml/apis/opik-rest-api.md) · [Page](https://skmtc.dev/comet-ml/apis/opik-rest-api/changes/v1/private/spans/get)