---
title: "List users"
method: GET
path: "/v2/users"
tags: ["Users"]
---

# List users

`GET /v2/users`

This endpoint lists all users. To find a user id by email, you can filter using the `email` query parameter.

## Query parameters

- `cursor` string, nullable
- `limit` integer, nullable
- `email` string, nullable — Currently only support filtering by a single email or a single remote_display_id.
- `remote_display_id` string, nullable — Currently only support filtering by a single email or a single remote_display_id.
- `expand[]` string[], nullable — Expandable fields that can be included in the response by passing in a query parameter e.g. ?expand[]=limit

## Response `200`

listUsers 200 response

- PageUserResponse
  - `next_cursor` string, nullable
  - `items` UserResponse[], required
    - `id` string, required
    - `first_name` string, required — First name of the user
    - `last_name` string, required — Last name of the user
    - `email` string, required — Email address of the user
    - `status` 'INVITED' | 'ACTIVE' | 'CLOSED' | 'DISABLED' | 'DELETED' | 'PENDING_ACTIVATION' | 'INACTIVE' | 'ARCHIVED' — Status of the user
    - `manager_id` string, nullable — The user id of the manager of this user
    - `department_id` string, nullable
    - `location_id` string, nullable
    - `title_id` string, nullable
    - `metadata` object, nullable — The metadata or customized attributes of the user. Maximum number of entries: 100
    - `remote_display_id` string, nullable — Identifier that is displayed on the IDP or HR system, eg, if OKTA identifies you as user xyz

---

[API](https://skmtc.net/brex-com/apis/team-api.md) · [All operations](https://skmtc.net/brex-com/apis/team-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brex-com/team-api/revisions/58e231ca118e/schema)