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

# GET /users/me/entities_to_compare/{poll_name}/

`GET /users/me/entities_to_compare/{poll_name}/`

## 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`

Retrieve suggested entities to compare for the logged user

## Path parameters

- `poll_name` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `first_entity_uid` string

## Response `200`

- PaginatedEntityNoExtraFieldList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` EntityNoExtraField[], required
    - `uid` string, required: A unique identifier, build with a namespace and an external id.
    - `type` 'video' | 'candidate_fr_2022', required: * `video` - Video * `candidate_fr_2022` - Candidate (FR 2022)
    - `metadata` object, required

## 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`
- **2022-06-09** `dfb76cc74711`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/users/me/entities_to_compare/:poll_name/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)