---
title: "List Users"
method: GET
path: "/api/v1/meta/users"
tags: ["Account Information", "Public API"]
---

# List Users

`GET /api/v1/meta/users`

Returns all users for the company, optionally filtered by status. Each user entry includes a user ID, associated employee ID, name, email address (resolved in priority order: work, home, account), account status, and last login time when available.

Pass a comma-separated list of status values via the `status` query parameter to filter results. Valid values are `enabled` and `disabled`. If the parameter is omitted or contains only unrecognized values, users of all statuses are returned. Support admin accounts are always excluded from the response.

The response format is determined by the `Accept` request header. Send `Accept: application/json` to receive JSON; omit the header or send any other value to receive XML.

OAuth Scopes: user

## Query parameters

- `status` string

## Headers

- `AcceptHeaderParameter` 'application/xml' | 'application/json'

## Response `200`

An object whose keys are user IDs (as strings) and whose values are user objects. When the Accept header requests XML, a `<users>` document is returned instead.

- object — Object keyed by user ID. Each key is a user ID string; each value is a user object.

## Other responses

- `401` — Unauthorized. The API key is missing or invalid.
- `403` — Forbidden. The caller does not have permission to access this endpoint.

---

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