---
title: "GET /users/me/suggestions/{poll_name}/tocompare/"
method: GET
path: "/users/me/suggestions/{poll_name}/tocompare/"
tags: ["users"]
---

# GET /users/me/suggestions/{poll_name}/tocompare/

`GET /users/me/suggestions/{poll_name}/tocompare/`

## Request

- The document declares no server URL.
- Auth: OAuth 2
  - Password
  - Token URL: `http://127.0.0.1:8000/o/token/` scopes: `read write groups`

Suggest a list of entities to compare to the logged-in user.

The suggestion strategy is determined by the `strategy` query parameter.

## Path parameters

- `poll_name` string, required

## Query parameters

- `strategy` 'classic' | 'watched'

## Response `200`

- EntityToCompare[]
  - `entity` RelatedEntity, required: An Entity serializer that will lookup and possibly create the Entity object on validation, if it does not exist in the database yet. Only the field `uid` is provided when using write HTTP methods. Used by ModelSerializer(s) having one or more nested relations with Entity, and having the constraint to ensure that entity instances exist before they can be saved properly.
    - `uid` string, required
    - `type` 'video' | 'candidate_fr_2022', required: * `video` - Video * `candidate_fr_2022` - Candidate (FR 2022)
    - `metadata` object, required
  - `collective_rating` CollectiveRating, required
    - `n_comparisons` integer, required: Total number of pairwise comparisons for this entityfrom certified contributors
    - `n_contributors` integer, required: Total number of certified contributors who rated the entity
    - `tournesol_score` number, double, nullable, required: The aggregated score of the main criterion for all users, in a specific poll.
    - `unsafe` UnsafeStatus, required
      - `status` boolean, required
      - `reasons` ReasonsEnum[], required

## Changes

- **2026-05-17** `c341ab3cf03a`: 1 breaking, 1 info
  - for the `query` request parameter `strategy`, default value was changed from `classic` to `watched`
  - added the new enum value `watched` to the `query` request parameter `strategy`
- **2026-05-17** `1e721b758a1f`: 2 breaking
  - for the `query` request parameter `strategy`, default value was changed from `watched` to `classic`
  - removed the enum value `watched` from the `query` request parameter `strategy`
- **2026-04-10** `c555b4bdf295`: 1 breaking, 1 info
  - for the `query` request parameter `strategy`, default value was changed from `classic` to `watched`
  - added the new enum value `watched` to the `query` request parameter `strategy`
- **2023-11-30** `834066e5d795`: 1 warning
  - added the new `moderation_by_contributors` enum value to the `items/collective_rating/allOf[#/components/schemas/CollectiveRating]/unsafe/allOf[#/components/schemas/UnsafeStatus]/reasons/items/` response property for the response status `200`
- **2023-11-22** `8e45c6d6f248`: 2 info
  - api operation id `users_me_suggestions_tocompare_retrieve` removed and replaced with `users_me_suggestions_tocompare_list`
  - added the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/users/me/suggestions/:poll_name/tocompare/get.md)

---

[API](https://skmtc.dev/tournesol-app/apis/tournesol-api.md) - [All operations](https://skmtc.dev/tournesol-app/apis/tournesol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tournesol-app/apis/tournesol-api/revisions/96c8c62ad972?raw)