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

# GET /entities/

`GET /entities/`

Fetch entities and their detailed scores in all polls

## Query parameters

- `limit` integer
- `offset` integer
- `type` 'candidate_fr_2022' | 'video'
- `poll_name` string

## Response `200`

- PaginatedEntityList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Entity[], 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
    - `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

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

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