---
title: "Get a bounded admin user page"
method: GET
path: "/v1/admin/users"
tags: ["Admin"]
---

# Get a bounded admin user page

`GET /v1/admin/users`

Returns one bounded page of users plus required pagination metadata. Search runs across the global user set and optional billing enrichment stays page-scoped.

## Query parameters

- `includeBilling` string
- `limit` string
- `offset` string
- `search` string

## Response `200`

Admin user page returned successfully.

- AdminUsersPageResponse
  - `users` object[], required
  - `page` AdminPageInfo, required
    - `total` number, required
    - `limit` number, required
    - `offset` number, required
    - `returned` number, required
    - `hasMore` boolean, required
    - `search` string, required
    - `durationMs` number, required
  - `billing` object, required
    - `loaded` boolean, required
    - `paidUsers` number, nullable, required
    - `unpaidUsers` number, nullable, required
    - `billingUnavailableUsers` number, nullable, required
  - `generatedAt` string, date-time, required

## Other responses

- `400` — The admin user page query parameters were invalid.
- `401` — The caller must be authenticated.
- `403` — The authenticated user is not an admin.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/805150503452/schema)