List groups

List Frontier Gateway groups in your workspace. Cursor-paginated, with optional lookup by external identifier.

curl

curl --request GET \
  --url https://api.baseten.co/v1/gateway/groups \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

200

{
  "items": [
    {
      "id": "abc123hash",
      "metadata": { "name": "Acme prod", "external_entity_id": "cust_42" },
      "models": [
        {
          "slug": "your-org/your-model",
          "rate_limits": [
            { "type": "TOKEN", "unit": "MINUTE", "threshold": 1000000 }
          ],
          "usage_limits": []
        }
      ],
      "effective_models": [
        {
          "slug": "your-org/your-model",
          "rate_limits": [
            { "type": "TOKEN", "unit": "MINUTE", "threshold": 1000000, "source_group": "abc123hash" }
          ],
          "usage_limits": []
        }
      ],
      "hierarchy": { "limit_enforcement": "INDEPENDENT", "parent_group_id": null },
      "created_at": "2026-05-13T12:00:00Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "cursor": "aVd2Yk54T2d2V0dFWE13R1l4R2k5UVE="
  }
}

List groups visible to your workspace, cursor-paginated. Pass external_entity_id to look up a single group by its external identifier.

Query parameters

external_entity_id · string

Filter results to groups whose metadata.external_entity_id matches this value exactly. Because external_entity_id is unique per workspace, the response contains at most one item. Combinable with limit and cursor.

limit · integer

Page size. Default 100, maximum 1000.

cursor · string

Pagination cursor from the previous response’s pagination.cursor. Omit on the first call.

Errors

Status	Meaning
403 Forbidden	Workspace isn’t onboarded to Frontier Gateway, or the caller doesn’t have view scope.

curl

curl --request GET \
  --url https://api.baseten.co/v1/gateway/groups \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

200

{
  "items": [
    {
      "id": "abc123hash",
      "metadata": { "name": "Acme prod", "external_entity_id": "cust_42" },
      "models": [
        {
          "slug": "your-org/your-model",
          "rate_limits": [
            { "type": "TOKEN", "unit": "MINUTE", "threshold": 1000000 }
          ],
          "usage_limits": []
        }
      ],
      "effective_models": [
        {
          "slug": "your-org/your-model",
          "rate_limits": [
            { "type": "TOKEN", "unit": "MINUTE", "threshold": 1000000, "source_group": "abc123hash" }
          ],
          "usage_limits": []
        }
      ],
      "hierarchy": { "limit_enforcement": "INDEPENDENT", "parent_group_id": null },
      "created_at": "2026-05-13T12:00:00Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "cursor": "aVd2Yk54T2d2V0dFWE13R1l4R2k5UVE="
  }
}

Authorizations

Authorization · string · header · required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Response

200 - application/json

items · GroupV1 · object[] · required

Items in this page.

Show child attributes

pagination · PaginationResponseV1 · object · required

Pagination metadata for the page.

Show child attributes