---
title: "List Access Groups"
method: GET
path: "/access_group/list"
tags: ["model management"]
---

# List Access Groups

`GET /access_group/list`

List all access groups.

Returns a list of all access groups with their model names, deployment counts, shared budget
and the spend drawn against it.

Example:
```bash
curl -X GET 'http://localhost:4000/access_group/list' \
  -H 'Authorization: Bearer sk-1234'
```

Returns:
- ListAccessGroupsResponse with all access groups

## Response `200`

Successful Response

- ListAccessGroupsResponse
  - `access_groups` AccessGroupInfo[], required
    - `access_group` string, required
    - `model_names` string[], required
    - `deployment_count` integer, required
    - `spend` number, nullable
    - `budget` AccessGroupBudget
      - `budget_id` string, required
      - `max_budget` number, nullable
      - `soft_budget` number, nullable
      - `budget_duration` string, nullable
      - `budget_reset_at` string, date-time, nullable

## Changes

- **2026-09-18** `082b5fabd909` — 2 info
  - added the optional property `access_groups/items/budget` to the response with the `200` status
  - added the optional property `access_groups/items/spend` to the response with the `200` status

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/access_group/list/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/b694deb1e459?raw)