---
title: "GET /gateway/v2/concentration-rule"
method: GET
path: "/gateway/v2/concentration-rule"
tags: ["cli_concentration-rule_gateway_v2_9"]
---

# GET /gateway/v2/concentration-rule

`GET /gateway/v2/concentration-rule`

## Request

- Base URL: `https://developers.conduktor.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developers.conduktor.io/gateway/v2/concentration-rule`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-gateway-api/docs/gateway/v2/concentration-rule/get.ts> (a function with typed inputs; its response is checked against the schema)

[![Generally Available](https://img.shields.io/badge/Lifecycle-Generally%20Available-blue)](#tag/Versioning)

List the concentration rules of a virtual cluster

## Query parameters

- `vcluster` string
- `name` string
- `showDefaults` boolean

## Response `200`

- ConcentrationRule[]
  - `kind` string, required: The kind of the concentration rule
  - `apiVersion` string, required: The api version of the concentration rule
  - `metadata` ConcentrationRuleMetadata, required: The metadata of the concentration rule
    - `name` string, ^[a-zA-Z0-9._-]+$, required: The name of the concentration rule (identifier in a virtual cluster)
    - `vCluster` string: The virtual cluster of the concentration rule. Default to `passthrough` if not provided.
  - `spec` ConcentrationRuleSpec, required: The specification of the concentration rule
    - `pattern` string, required: The pattern of the concentration rule
    - `physicalTopics` PhysicalTopics, required: The physical topics backing the concentrated logical topics
      - `delete` string, ^[a-zA-Z0-9._-]+$, required: The name of the physical topic to store the data of the concentrated topics created with a 'delete' policy. The topic must exist in the physical kafka cluster with a 'delete' cleanup.policy (except if you use the autoManaged mode)
      - `compact` string, ^[a-zA-Z0-9._-]+$: The name of the physical topic to store the data of the concentrated topics created with a 'compact' policy. If specified, the topic must exist in the physical kafka cluster with a 'compact' cleanup.policy (except if you use the autoManaged mode)
      - `deleteCompact` string, ^[a-zA-Z0-9._-]+$: The name of the physical topic to store the data of the concentrated topics created with a 'delete,compact' policy. If specified, the topic must exist in the physical kafka cluster with a 'delete,compact' cleanup.policy (except if you use the autoManaged mode)
    - `autoManaged` boolean: Whether the concentration rule is auto managed
    - `offsetCorrectness` boolean: Deprecated since v3.21.0, planned for removal in v3.24.0. Set the offset management on/off for the logical topics created with this rule (default to false). Setting it on can have some impacts on the performances and the memory usage.

## Other responses

- `400`: The request is not valid
- `401`: The given credentials are not valid
- `404`: The given virtual cluster does not exist
- `500`: An unexpected error occurred in the server

---

[API](https://skmtc.dev/conduktor/apis/conduktor-gateway-api.md) - [All operations](https://skmtc.dev/conduktor/apis/conduktor-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conduktor/apis/conduktor-gateway-api/revisions/73ad742aa630?raw)