---
title: "Changes to Get trace annotations filtered by trace_ids and/or identifier."
method: GET
path: "/v1/projects/{project_identifier}/trace_annotations"
---

# Changes to Get trace annotations filtered by trace_ids and/or identifier.

`GET /v1/projects/{project_identifier}/trace_annotations`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 70 revisions.

- **2026-04-30** `4c3ecf13cbaa` — 5 info
- **2026-04-29** `c81391216eb5` — 4 breaking, 1 warning

## Changes

- **2026-04-30** `4c3ecf13cbaa` — 5 info
  - added the new optional `query` request parameter `identifier`
  - the `query` request parameter `trace_ids` became optional
  - `query` request parameter `trace_ids` list-of-types was widened by adding types `null`
  - for the `query` request parameter `trace_ids`, the minItems was decreased from `1` to `0`
  - for the `query` request parameter `trace_ids`, the type/format was generalized from `array`/`` to ``/``
- **2026-04-29** `c81391216eb5` — 4 breaking, 1 warning
  - the `query` request parameter `trace_ids` became required
  - `query` request parameter `trace_ids` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `trace_ids`, the minItems was increased from `0` to `1`
  - for the `query` request parameter `trace_ids`, the type/format was changed from ``/`` to `array`/``
  - deleted the `query` request parameter `identifier`

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/docs/v1/projects/:project_identifier/trace_annotations/get.md) · [API](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api.md) · [Page](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/changes/v1/projects/:project_identifier/trace_annotations/get)