Get a group

Fetch a single Frontier Gateway group by its internal id, including its effective limits after inheritance.

curl

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

200

{
  "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"
}

Fetch one group by its internal id. The response includes the group’s own models configuration plus the post-inheritance effective_models block. To look up a group by your external identifier instead, use List groups with ?external_entity_id=.

Errors

Status	Meaning
403 Forbidden	The group exists but isn’t in your workspace, or the caller doesn’t have management scope.
404 Not Found	No group with this id in your workspace, or it has been deleted.

curl

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

200

{
  "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"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

group_id · string · required

Response

200 - application/json

id · string · required

Internal Baseten ID for the group.

metadata · GroupMetadataV1 · object · required

Group identity + display metadata.

Show child attributes

hierarchy · GroupHierarchyV1 · object · required

Parent linkage and limit enforcement mode. Parent is null for root groups.

Show child attributes

created_at · string<date-time> · required

When this group was created.

models · ModelConfigV1 · object[]

Show child attributes

effective_models · EffectiveModelConfigV1 · object[]

Show child attributes