---
title: "Changes to GET /polls/{name}/recommendations/"
method: GET
path: "/polls/{name}/recommendations/"
---

# Changes to GET /polls/{name}/recommendations/

`GET /polls/{name}/recommendations/`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 50 revisions.

- **2024-12-19** `3bba1a8d6651` — 2 info
- **2023-11-30** `834066e5d795` — 1 warning, 1 info
- **2023-11-22** `8e45c6d6f248` — 1 warning
- **2023-09-28** `9671427c6f2e` — 9 breaking, 3 info
- **2023-08-24** `5605b608cade` — 2 breaking, 9 info
- **2023-08-06** `1e267e561ebb` — 1 info
- **2023-07-25** `2b1b5960cdcd` — 1 info
- **2023-07-04** `b0f74d913a83` — 6 breaking, 1 warning, 8 info

## Changes

- **2024-12-19** `3bba1a8d6651` — 2 info
  - the response property `count` became required for the status `200`
  - the response property `results` became required for the status `200`
- **2023-11-30** `834066e5d795` — 1 warning, 1 info
  - added the new `moderation_by_contributors` enum value to the `results/items/collective_rating/allOf[#/components/schemas/ExtendedCollectiveRating]/unsafe/allOf[#/components/schemas/UnsafeStatus]/reasons/items/` response property for the response status `200`
  - added the required property `results/items/entity_contexts` to the response with the `200` status
- **2023-11-22** `8e45c6d6f248` — 1 warning
  - added the new `moderation_by_association` enum value to the `results/items/collective_rating/allOf[#/components/schemas/ExtendedCollectiveRating]/unsafe/allOf[#/components/schemas/UnsafeStatus]/reasons/items/` response property for the response status `200`
- **2023-09-28** `9671427c6f2e` — 9 breaking, 3 info
  - removed the required property `results/items/criteria_scores` from the response with the `200` status
  - removed the required property `results/items/metadata` from the response with the `200` status
  - removed the required property `results/items/n_comparisons` from the response with the `200` status
  - removed the required property `results/items/n_contributors` from the response with the `200` status
  - removed the required property `results/items/total_score` from the response with the `200` status
  - removed the required property `results/items/tournesol_score` from the response with the `200` status
  - removed the required property `results/items/type` from the response with the `200` status
  - removed the required property `results/items/uid` from the response with the `200` status
  - removed the required property `results/items/unsafe` from the response with the `200` status
  - added the required property `results/items/collective_rating` to the response with the `200` status
  - added the required property `results/items/entity` to the response with the `200` status
  - added the required property `results/items/recommendation_metadata` to the response with the `200` status
- **2023-08-24** `5605b608cade` — 2 breaking, 9 info
  - the `results/items/uid` response property's maxLength was unset from `144` for the response status `200`
  - the `results/items/type` response's property type changed from `string` to no type for status `200`
  - the response optional property `results/items/tournesol_score` became read-only for the status `200`
  - the response optional property `results/items/unsafe` became read-only for the status `200`
  - added `#/components/schemas/TypeEnum` to the `results/items/type` response property `allOf` list for the response status `200`
  - the response property `results/items/tournesol_score` became required for the status `200`
  - the response property `results/items/unsafe` became required for the status `200`
  - removed the `candidate_fr_2022` enum value from the `results/items/type` response property for the response status `200`
  - removed the `video` enum value from the `results/items/type` response property for the response status `200`
  - the response required property `results/items/type` became read-only for the status `200`
  - the response required property `results/items/uid` became read-only for the status `200`
- **2023-08-06** `1e267e561ebb` — 1 info
  - added the new optional `query` request parameter `exclude_compared_entities`
- **2023-07-25** `2b1b5960cdcd` — 1 info
  - added the optional property `results/items/unsafe` to the response with the `200` status
- **2023-07-04** `b0f74d913a83` — 6 breaking, 1 warning, 8 info
  - the response property `count` became optional for the status `200`
  - the response property `results` became optional for the status `200`
  - removed the required property `results/items/collective_rating` from the response with the `200` status
  - removed the required property `results/items/entity` from the response with the `200` status
  - removed the required property `results/items/entity_contexts` from the response with the `200` status
  - removed the required property `results/items/recommendation_metadata` from the response with the `200` status
  - deleted the `query` request parameter `exclude_compared_entities`
  - added the optional property `results/items/tournesol_score` to the response with the `200` status
  - added the required property `results/items/criteria_scores` to the response with the `200` status
  - added the required property `results/items/metadata` to the response with the `200` status
  - added the required property `results/items/n_comparisons` to the response with the `200` status
  - added the required property `results/items/n_contributors` to the response with the `200` status
  - added the required property `results/items/total_score` to the response with the `200` status
  - added the required property `results/items/type` to the response with the `200` status
  - added the required property `results/items/uid` to the response with the `200` status

---

[Operation](https://skmtc.dev/tournesol-app/apis/tournesol-api/docs/polls/:name/recommendations/get.md) · [API](https://skmtc.dev/tournesol-app/apis/tournesol-api.md) · [Page](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/polls/:name/recommendations/get)