---
search:
  tags:
    - Users
    - GET
seo:
  description: >-
    Admin only. Returns a page of user records, each with the name of its
    branch. The list is… Reference for the GET /api/v1/users endpoint in the
    PharmaFlow API.
sidebar:
  label: List users
  badge: GET
title: List users
type: openapi-operation
---
Admin only. Returns a page of user records, each with the name of its branch. The list is active by default, so a deactivated record needs is_active false or all.

`GET /api/v1/users`

**Responses**

- `200` — A page of users
- `401` — Not authenticated
- `403` — Caller is not an admin

Response example, 200:

```json
{
  "total": -9007199254740991,
  "page": -9007199254740991,
  "page_size": -9007199254740991,
  "items": [
    {
      "id": "string",
      "branch_id": "string",
      "email": "string",
      "full_name": "string",
      "phone": "string",
      "role": "string",
      "is_active": true,
      "last_login_at": "string",
      "created_at": "string",
      "updated_at": "string",
      "branch_name": "string"
    }
  ]
}
```