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

# Get all users

`GET /users`

## Query parameters

- `limit` integer — Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
- `start_after` string, uuid — The ID of the user to start the page after (exclusive). When provided, results will begin with the user immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
- `end_before` string, uuid — The ID of the user to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
- `order` 'asc' | 'desc' — Sort order. Can be 'asc' or 'desc'. Defaults to 'asc'

## Response `200`

- UsersPaginatedResponse — Paginated response containing a list of organization users.
  - `page` object, required — Pagination information including cursors for navigating to next/previous pages
    - `nextPage` string, uuid — ID for the user
    - `previousPage` string, uuid — ID for the user
  - `users` UserDetails[], required — List of users in the current page
    - `email` string, required — User's email address
    - `firstName` string, required — User's first name
    - `lastName` string, required — User's last name
    - `organizationRole` 'administrator' | 'bookkeeper' | 'customUser' | 'cardOnlyUser' | 'employee', required — User's role within the organization
    - `userId` string, uuid, required — Unique identifier for the user

## Other responses

- `400` — Invalid `order` or `end_before` or `start_after` or `limit`

---

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