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

# GET /users

`GET /users`

Lists all users.

## Response `200`

Success

- UserListResponse — List of users.
  - `data` User[], required — List of users.
    - `id` string, required — FRAGMENT generated unique ID.
    - `external_id` string, required — User-provided unique ID.
    - `tags` Tag[], required — Tags for the user.
      - `key` string, required — Tag key.
      - `value` string, required — Tag value.

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-05-11** `91a072ddf86d` — 1 breaking
  - removed the required property `data/items/role` from the response with the `200` status
- **2026-04-23** `2313a4acc241` — 2 info
  - response property `data/items/role` deprecated
  - added the required property `data/items/tags` to the response with the `200` status
- **2026-03-13** `dd22ecbbe8e5` — 1 breaking
  - removed the required property `data/items/externalId` from the response with the `200` status
- **2026-03-06** `6768d46dbde8` — 2 info
  - response property `data/items/externalId` deprecated
  - added the required property `data/items/external_id` to the response with the `200` status
- **2026-02-05** `635b1d55b735` — 1 info
  - added the required property `data/items/id` to the response with the `200` status

[Full history](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/changes/users/get.md)

---

[API](https://skmtc.dev/fragment-dev/apis/fragment-payments-api.md) · [All operations](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fragment-dev/fragment-payments-api/revisions/41ca2c686012/schema)