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

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

`GET /users/me/contributor_ratings/{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 the logged-in user's ratings per entity in a given poll (computed automatically from the user's comparisons).

## Path parameters

- `poll_name` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `is_public` boolean
- `order_by` string

## Response `200`

- PaginatedContributorRatingList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ContributorRating[], required
    - `entity` EntityNoExtraField, required: An Entity serializer that doesn't include extra fields.
      - `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
    - `entity_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
    - `individual_rating` ExtendedInvididualRating, required
      - `is_public` boolean, required: Should the rating be public?
      - `entity_seen` boolean, required: Has the user already seen, or read, or understood the entity?
      - `n_comparisons` integer, required
      - `criteria_scores` ContributorCriteriaScore[], required
        - `criteria` string, required: Name of the criteria
        - `score` number, double: Score for the given criteria, after individual and poll scalings applied
        - `uncertainty` number, double: Uncertainty about the criteria score
      - `last_compared_at` string, date-time, nullable, required
    - `collective_rating` ExtendedCollectiveRating, 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
      - `criteria_scores` EntityCriteriaScore[], required
        - `criteria` string, required: Name of the criteria
        - `score` number, double: Score of the given criteria

## Changes

- **2025-11-28** `b3077f24157d`: 2 info
  - added `#/components/schemas/ExtendedCollectiveRating` to the `results/items/collective_rating` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/CollectiveRating` from the `results/items/collective_rating` response property `allOf` list for the response status `200`
- **2025-08-19** `09b6010f79c7`: 1 info
  - added the required property `results/items/individual_rating/allOf[#/components/schemas/ExtendedInvididualRating]/entity_seen` to the response with the `200` status
- **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** `33b072a42c75`: 1 info
  - added the required property `results/items/entity_contexts` to the response with the `200` status
- **2023-11-30** `834066e5d795`: 1 warning
  - added the new `moderation_by_contributors` enum value to the `results/items/collective_rating/allOf[#/components/schemas/CollectiveRating]/unsafe/allOf[#/components/schemas/UnsafeStatus]/reasons/items/` response property for the response status `200`

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