---
title: "GET /entities/{uid}/"
method: GET
path: "/entities/{uid}/"
tags: ["entities"]
---

# GET /entities/{uid}/

`GET /entities/{uid}/`

Fetch entities and their detailed scores in all polls

## Path parameters

- `uid` string, required — A unique identifier, build with a namespace and an external id.

## Query parameters

- `type` 'candidate_fr_2022' | 'video'
- `poll_name` string

## Response `200`

- Entity — An Entity serializer that also includes polls. Use `EntityNoExtraFieldSerializer` if you don't need the related polls.
  - `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
  - `polls` EntityPoll[], required
    - `name` string, required
    - `criteria_scores` EntityCriteriaScore[], required
      - `criteria` string, required — Name of the criteria
      - `score` number, double — Score of the given criteria

## Changes

- **2023-12-19** `9c07a86ca426` — 1 breaking
  - removed the required property `tournesol_score` from the response with the `200` status
- **2023-09-28** `9671427c6f2e` — 2 breaking, 7 info
  - the `uid` response property's maxLength was unset from `144` for the response status `200`
  - the `type` response's property type changed from `string` to no type for status `200`
  - the response optional property `metadata` became read-only for the status `200`
  - added `#/components/schemas/TypeEnum` to the `type` response property `allOf` list for the response status `200`
  - …5 more
- **2023-07-04** `b0f74d913a83` — 2 breaking, 2 warning, 5 info
  - the response property `metadata` became optional for the status `200`
  - the `type` response's property type changed from no type to `string` for status `200`
  - added the new `candidate_fr_2022` enum value to the `type` response property for the response status `200`
  - added the new `video` enum value to the `type` response property for the response status `200`
  - …5 more

[Change history](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/entities/:uid/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)