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

# List individual entity groups' AI credit limits

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

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/ai/credit-controls/entity-groups`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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

List the organization's active individual embed entity-group AI credit limits, ordered by entity group id ascending.

Only entity groups with an individual limit will be returned in the response. Entity groups that use the organization default are not included.

## Query parameters

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

## Response `200`

One page of entity groups' 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: Entity groups with an individual AI credit limit, ordered by 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.
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)
- `500`: Internal Server Error

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/ai/credit-controls/entity-groups/get.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)