---
title: "Get all entity users"
method: GET
path: "/entity_users"
tags: ["Entity users"]
---

# Get all entity users

`GET /entity_users`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/entity_users`
- Auth: HTTP bearer

Retrieve a list of all entity users.

## Query parameters

- `order` 'asc' | 'desc'
- `limit` integer
- `pagination_token` string
- `sort` 'updated_at'
- `id__in` string, uuid
- `id__not_in` string, uuid
- `role_id` string, uuid
- `role_id__in` string, uuid
- `login` string
- `status` string
- `first_name` string
- `name__istartswith` string
- `created_at__gt` string, date-time
- `created_at__lt` string, date-time
- `created_at__gte` string, date-time
- `created_at__lte` string, date-time

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Response `200`

Successful Response

- EntityUserPaginationResponse
  - `data` EntityUserResponse[], required: array of records
    - `id` string, uuid, required: A unique Monite-assigned ID of this entity user. Can be used with `POST /auth/token` to generate an API access token for this user.
    - `created_at` string, date-time, required: UTC date and time when this user was created in Monite.
    - `updated_at` string, date-time, required: UTC date and time when this user was last updated.
    - `email` string, email: The user's business email address.
    - `first_name` string: The user's first name.
    - `last_name` string: The user's last name.
    - `login` string, required: The username assigned to this user. Usernames must be unique within the entity. The `login` value is not used by Monite but may be used by partner applications, for example, to map the users between the partner's platform and Monite.
    - `phone` string: The user's phone number.
    - `role_id` string, uuid, required: ID of the role assigned to this user. The role defines the user's [access permissions](https://docs.monite.com/api/concepts/authentication#permissions) within the entity. Each user has just one role.
    - `status` 'active' | 'deleted', required
    - `userpic_file_id` string, uuid: Unused. Reserved for future use. Currently always returns `null`.
  - `next_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the next page of results, or `null` if there is no next page (i.e. you've reached the last page).
  - `prev_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the previous page of results, or `null` if there is no previous page (i.e. you've reached the first page).

## Other responses

- `400`: Bad Request
- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `403`: The specified access token does not have permissions to perform this operation.
- `406`: Not Acceptable
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)