---
title: "Get users"
method: GET
path: "/v2/users"
tags: ["User"]
---

# Get users

`GET /v2/users`

## Request

- Base URL: `https://api.sandbox.eu.bandyer.com`
- URL: `https://api.sandbox.eu.bandyer.com/v2/users`
- Auth: API key in header `apikey`

Get a list of users.

## Query parameters

- `offset` integer
- `limit` integer
- `role` 'basic' | 'plus': User role.
- `allow_camera` boolean
- `active` boolean
- `search` string

## Response `200`

- object
  - `offset` integer: The number of items to skiped before starting to collect the result set.
  - `limit` integer: The numbers of items to returned.
  - `has_more` boolean: Indicates is there more values.
  - `count` integer: Total number of values returned.
  - `users` object[]
    - `id` string: User Id.
    - `role` string: User role.
    - `allow_camera` boolean: Indicates if user is allowed to do video call or not.
    - `language` string: User language.
    - `creation_date` string, date-time: Creation date of the user.
    - `avatar_url` string: Avatar resource url of the user. **The file pointed by this URL is treated as PII/PHI**
    - `active` boolean: Indicates if the user active or not.

## Other responses

- `401`: Unauthorized
- `429`: Too Many request

---

[API](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2.md) - [All operations](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2/revisions/4424fd54ae42?raw)
