---
title: "List users"
method: GET
path: "/rest/users"
---

# List users

`GET /rest/users`

## Query parameters

- `fields` string

## Request body

- object
  - `country` string — Country of residence of this user. Allowed values are [ISO 3166-1 alpha-2 country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). <br>**Sample value:** `us`
  - `exclude_ids` string — List of user IDs to exclude from the result set. <br>**Sample value:** `xk2k3, x26m1j4, xkeg4`<br>**Max length:** 150
  - `ids` string — Limit the result set to this list of user channels identifiers.<br>**Sample value:** `xk2k3, x1fz4ii, xw83x45`<br>**Max length:** 150
  - `language` string — Limit the result set to users using this language. Allowed values are **[ISO-639-3 alpha-2 and alpha-3](https://en.wikipedia.org/wiki/ISO_639-3)** language codes. <br>**Sample value:** `en`<br>**Min length:** 1 <br>**Max length:** 150
  - `mostpopular` boolean — Limit the result set to the most popular users.
  - `parent` string — Limit the result set to children profiles of this user. <br>**Sample value:** `xetqwhl`
  - `partner` boolean — Limit the result set to premium profiles.
  - `recommended` boolean — Limit the result set to recommended profiles.
  - `recommendedforchannel` string — Limit the result set to top profiles within a category. <br>**Possible values:** `animals` `creation` `auto` `school` `people` `fun` `videogames` `tech` `kids` `lifestyle` `shortfilms` `music` `news` `sport` `tv` `travel` `webcam`
  - `sort` string — Change the default result set ordering. <br>**Possible values:** `recent` `relevance` `popular` `activity`
  - `usernames` string[] — Limit the results set to profiles with a list of usernames. <br>**Sample value:** `dailymotion,canalplus`<br>**Min length:** 1 <br>**Max length:** 150
  - `verified` boolean — Limit the result set to verified partner profiles.

## Response `200`

---

[API](https://skmtc.net/dailymotion/apis/partner-api.md) · [All operations](https://skmtc.net/dailymotion/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dailymotion/partner-api/versions/68bb377627b7/schema)