---
title: "Get user"
method: GET
path: "/v2/users/{id}"
tags: ["Users"]
---

# Get user

`GET /v2/users/{id}`

This endpoint gets a user by ID.

## Path parameters

- `id` string, required

## Response `200`

getUserById 200 response

- UserResponse
  - `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)