---
title: "Get User"
method: GET
path: "/core/v1/user"
tags: ["Users"]
---

# Get User

`GET /core/v1/user`

Returns a user for an organization based on either provided user ID or an external ID set during creation.

## Query parameters

- `user_id` string — The unique identifier of the user managed by Verkada.
- `external_id` string — A unique identifier managed externally provided by the consumer.

## Response `200`

OK

- GetUserResponse — Response schema for the get user endpoint.
  - `active` boolean — Whether the user is active in the system.
  - `company_name` string — The name of the company the user is part of.
  - `department` string — The name of the department the user is part of.
  - `department_id` string — The department ID of the department the user is in.
  - `email` string — The email of the user.
  - `employee_id` string — The user's employee ID, does not have to be unique.
  - `employee_title` string — The title of employee.
  - `employee_type` string — The type of employee.
  - `external_id` string — A unique identifier managed externally provided by the consumer.
  - `first_name` string — The first name of the user.
  - `last_name` string — The last name of the user.
  - `middle_name` string — The middle name of the user.
  - `phone` string — The main phone number of a user, E.164 format preferred.
  - `user_id` string — The unique identifier of the user managed by Verkada.

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/verkada/apis/api-tokens.md) · [All operations](https://skmtc.net/verkada/apis/api-tokens/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verkada/api-tokens/revisions/4a79d2d949a6/schema)