---
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}/`

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

---

[API](https://skmtc.net/tournesol-app/apis/tournesol-api.md) · [All operations](https://skmtc.net/tournesol-app/apis/tournesol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tournesol-app/tournesol-api/revisions/96c8c62ad972/schema)