# rpk ai budget list

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [agentic-data-plane-full.txt](https://docs.redpanda.com/agentic-data-plane-full.txt)

---
title: rpk ai budget list
latest-operator-version: v26.2.6
latest-console-tag: v3.14.0
latest-connect-version: 4.117.0
latest-redpanda-tag: v26.2.6
docname: rpk/rpk-ai/rpk-ai-budget-list
page-component-name: agentic-data-plane
page-version: master
page-component-version: master
page-component-title: Agentic Data Plane
page-relative-src-path: rpk/rpk-ai/rpk-ai-budget-list.adoc
page-edit-url: https://github.com/redpanda-data/adp-docs/edit/main/modules/reference/pages/rpk/rpk-ai/rpk-ai-budget-list.adoc
description: List Budgets.
page-git-created-date: "2026-10-26"
page-git-modified-date: "2026-10-26"
page-generated-sources:
  - include: streaming:reference:partial$rpk-ai/rpk-ai-budget-list.adoc
    generator: rpk-docs
    version: null
    source: the rpk command help in redpanda-data/streaming-enterprise
page-generated-content: partial
---

<!-- Source: https://docs.redpanda.com/agentic-data-plane/reference/rpk/rpk-ai/rpk-ai-budget-list.md -->

List Budgets.

> 📝 **NOTE**
>
> This command was introduced in ai version 0.2.94.

## [](#usage)Usage

```bash
rpk ai budget list [flags]
```

## [](#examples)Examples

This section provides examples of how to use `rpk ai budget list`.

```bash
rpk ai budget list --provider-name openai -o json
rpk ai budget list --agent-tags team=payments --pooling-mode shared
rpk ai budget list --agent-name agents/invoice
rpk ai budget list --page-size 50 --page-token CURSOR -o json
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| --name-contains | string | Name contains. |
| --agent-name | filter_agent_name | Budgets whose filter_agent_name is exactly this agent: the per-agent override. |
| --provider-name | filter_provider_names | Budgets whose filter_provider_names include this provider. |
| --agent-tags | filter_agent_tags | Budgets whose filter_agent_tags have, for every entry, a selector with that key whose values include that value. (repeatable key=value; replaces the full map on update). |
| --pooling-mode | string | Budgets with exactly this pooling mode: SHARED returns pools, PER_AGENT returns the tenant default and overrides. (one of: per-agent, shared). |
| --page-size | int32 | Page size. |
| --page-token | string | Page token. |

## [](#global-flags)Global flags

| Value | Type | Description |
| --- | --- | --- |
| --config | string | Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings; -X help for detail or -X list for terser detail. |
| --ignore-profile | bool | Ignore rpk.yaml and redpanda.yaml; use default settings. |
| --profile | string | rpk profile to use. |
| -v, --verbose | bool | Enable verbose logging. |