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

# GET /users/me/unconnected_entities/{poll_name}/{uid}/

`GET /users/me/unconnected_entities/{poll_name}/{uid}/`

## 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`

List unconnected entities of the current user from a target entity and the user's graph of comparisons (entities are vertices and comparisons are edges).

## Path parameters

- `poll_name` string, required
- `uid` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `strict` boolean

## Response `200`

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

## 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-01-29** `c5da379c3f18`: 3 breaking, 2 info
  - removed the required property `results/items/metadata` from the response with the `200` status
  - removed the required property `results/items/type` from the response with the `200` status
  - removed the required property `results/items/uid` from the response with the `200` status
  - added the required property `results/items/entity` to the response with the `200` status
  - …1 more
- **2023-01-10** `122bc80a6cd4`: 1 info
  - added the new optional `query` request parameter `strict`
- **2022-05-05** `aa2f0cdb734c`: 4 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`
  - removed the required property `results/items/polls` from the response with the `200` status
  - removed the required property `results/items/tournesol_score` from the response with the `200` status
  - …7 more
- **2022-04-26** `70a52b89a679`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/users/me/unconnected_entities/:poll_name/: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.dev/tournesol-app/apis/tournesol-api/revisions/96c8c62ad972?raw)
