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

# List Users

`GET /users`

## Request

- Base URL: `https://api.upflow.io/v1`
- URL: `https://api.upflow.io/v1/users`
- Auth: API key in header `X-Api-Key` and API key in header `X-Api-Secret`

This endpoint can be used to list users with optional filtering.

## Response `200`

List of users.

- UserListResponse
  - `users` User[]
    - `id` string, uuid, required: The User ID.
    - `position` 'ACCOUNT_MANAGER' | 'FINANCE_USER' | 'ACCOUNTANT', required: The role or position of the user within Upflow.
    - `firstName` string
    - `lastName` string
    - `phone1` string, nullable
    - `phone2` string, nullable
    - `email` string, email, required

---

[API](https://skmtc.dev/upflow/apis/upflow-api.md) - [All operations](https://skmtc.dev/upflow/apis/upflow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upflow/apis/upflow-api/revisions/898a98ca0587?raw)