---
title: "List individual users' AI credit limits"
method: GET
path: "/v1/ai/credit-controls/users"
tags: ["AI Credit Controls"]
---

# List individual users' AI credit limits

`GET /v1/ai/credit-controls/users`

<Note>
  **Organization Admin** permissions are required to use this endpoint.
</Note>

List the organization's active individual user AI credit limits, ordered by `userId` ascending.

Only users with an individual limit will be returned in the response.

## Query parameters

- `cursor` string — Cursor for pagination from previous response `nextCursor`
- `pageSize` integer — Number of results per page

## Response `200`

One page of users' individual AI credit limits.

- object
  - `pageInfo` PageInfo, required — Pagination information for paginated responses.
    - `hasNextPage` boolean — Indicates if there are more records available.
    - `nextCursor` string, nullable — Cursor for the next page of results. `null` if no more results.
    - `pageSize` integer — Number of records per page.
    - `totalRecords` integer — Total number of records matching the query.
  - `records` object[], required — Users with an individual AI credit limit, ordered by `userId` ascending.
    - `creditLimit` number, nullable, required — The user's individual AI credit limit, or `null` for an explicit unlimited override.
    - `userId` string, required — The user's id within this organization.

## Other responses

- `400` — Invalid cursor or pageSize.
- `401` — Missing or invalid API key.
- `403` — Insufficient permissions, or per-user AI credit limits are not enabled for the organization.
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)
- `500` — Internal Server Error

---

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