---
title: "List individual entity groups' AI credit limits"
method: GET
path: "/api/v1/ai/credit-controls/entity-groups"
tags: ["AI"]
---

# List individual entity groups' AI credit limits

`GET /api/v1/ai/credit-controls/entity-groups`

List the organization's active individual embed entity-group AI credit limits, keyed by the embed `entity` string. Only entity groups with an individual limit appear — everyone else follows the org default. A `null` creditLimit is an explicit unlimited override, distinct from following the default. Paginated via opaque cursors: pass `pageInfo.nextCursor` from one response as the `cursor` query parameter on the next request. Requires the same add/remove-users permission as the PATCH.

## Query parameters

- `cursor` string — Cursor for pagination (from previous response nextCursor)
- `pageSize` integer — Number of results per page (1-100, integer)

## Response `200`

One page of entity groups' individual AI credit limits.

- AiCreditControlsEntityGroupsListResponse
  - `pageInfo` PageInfo, required
    - `hasNextPage` boolean, required — Whether more results are available
    - `nextCursor` string, nullable, required — Cursor for fetching the next page
    - `pageSize` number, required — Number of results per page
    - `totalRecords` number, required — Total number of records matching the query
  - `records` object[], required — Entity groups with an individual AI credit limit, ordered by the entity group id.
    - `creditLimit` number, nullable, required — The entity group's individual AI credit limit, or `null` for an explicit unlimited override.
    - `entity` string, required — The embed entity's identifier (the SSO `entity` value).

## Other responses

- `400` — Invalid cursor or pageSize.
- `401` — Missing or invalid API key.
- `403` — Insufficient permissions, or per-entity-group AI credit limits are not enabled for the organization.

---

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