---
title: "List quotas"
method: GET
path: "/v1/quotas"
tags: ["Quotas"]
---

# List quotas

`GET /v1/quotas`

List client quotas. Use filter parameters to narrow results by entity type and filter criteria.

## Query parameters

- `filter.entity_type` 'ENTITY_TYPE_CLIENT_ID' | 'ENTITY_TYPE_CLIENT_ID_PREFIX' | 'ENTITY_TYPE_USER' | 'ENTITY_TYPE_IP'
- `filter.entity_name` string
- `filter.match_default` boolean
- `page_size` integer
- `page_token` string

## Response `200`

OK

- ListQuotasResponse
  - `page_token` string — Token to retrieve the next page of results. If empty, there are no more results.
  - `quotas` QuotaEntry[]
    - `entity` Entity
      - `entity_name` string
      - `entity_type` 'ENTITY_TYPE_CLIENT_ID' | 'ENTITY_TYPE_CLIENT_ID_PREFIX' | 'ENTITY_TYPE_USER' | 'ENTITY_TYPE_IP' — The type of entity that the quota applies to. - ENTITY_TYPE_USER: Not supported in Redpanda - ENTITY_TYPE_IP: Not supported in Redpanda
    - `values` QuotaValue[]
      - `value` number, double
      - `value_type` 'VALUE_TYPE_PRODUCER_BYTE_RATE' | 'VALUE_TYPE_CONSUMER_BYTE_RATE' | 'VALUE_TYPE_CONTROLLER_MUTATION_RATE' | 'VALUE_TYPE_REQUEST_PERCENTAGE' — The type of value that the quota represents. - VALUE_TYPE_PRODUCER_BYTE_RATE: The rate at which producers can send data. - VALUE_TYPE_CONSUMER_BYTE_RATE: The rate at which consumers can fetch data. - VALUE_TYPE_CONTROLLER_MUTATION_RATE: The rate at which topic mutation requests can be made. - VALUE_TYPE_REQUEST_PERCENTAGE: The percentage of the total throughput that can be used by the entity. Not supported in Redpanda

## Other responses

- `401` — Unauthenticated.
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

## Changes

- **2025-08-07** `f1edf2920514` — 1 info
  - endpoint added
- **2025-05-27** `dfa71f9d277e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/changes/v1/quotas/get.md)

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/revisions/7eef0bcc42e7/schema)
