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

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

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

Retrieve all comparisons made by the logged user, in a given poll.

## Path parameters

- `poll_name` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

- PaginatedComparisonList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Comparison[], required
    - `entity_a` 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
    - `entity_b` 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
    - `entity_a_contexts` EntityContext[], required
      - `origin` 'ASSOCIATION' | 'CONTRIBUTORS' — * `ASSOCIATION` - Association * `CONTRIBUTORS` - Contributors
      - `unsafe` boolean — If True, this context will make the targeted entities unsafe.
      - `text` string, required
      - `created_at` string, date-time, required
    - `entity_b_contexts` EntityContext[], required
      - `origin` 'ASSOCIATION' | 'CONTRIBUTORS' — * `ASSOCIATION` - Association * `CONTRIBUTORS` - Contributors
      - `unsafe` boolean — If True, this context will make the targeted entities unsafe.
      - `text` string, required
      - `created_at` string, date-time, required
    - `criteria_scores` ComparisonCriteriaScore[], required
      - `criteria` string, required — Name of the criteria
      - `score` number, double, required — Score for the given comparison
      - `score_max` integer, required — The absolute value of the maximum score.
      - `weight` number, double — Weight of the comparison
    - `duration_ms` number, double, nullable — Time it took to rate the videos (in milliseconds)

## 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`
- **2024-05-02** `250644b3d55e` — 1 info
  - added the required property `results/items/criteria_scores/items/score_max` to the response with the `200` status
- **2024-01-18** `c8dd025d9919` — 2 info
  - the `entity_a_contexts` response's property default value `` was added for the status `200`
  - the `entity_b_contexts` response's property default value `` was added for the status `200`
- **2024-01-04** `1ed44f2e2527` — 2 info
  - added the required property `results/items/entity_a_contexts` to the response with the `200` status
  - added the required property `results/items/entity_b_contexts` to the response with the `200` status
- **2023-07-04** `b0f74d913a83` — 5 breaking
  - 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/criteria_scores/items/score_max` from the response with the `200` status
  - removed the required property `results/items/entity_a_contexts` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/users/me/comparisons/: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-service-production.skmtc.workers.dev/v1/apis/tournesol-app/tournesol-api/revisions/96c8c62ad972/schema)