---
title: "ConsumerChains queries active consumer chains supported by the provider chain"
method: GET
path: "/interchain_security/ccv/provider/consumer_chains/{phase}"
tags: ["Query"]
---

# ConsumerChains queries active consumer chains supported by the provider chain

`GET /interchain_security/ccv/provider/consumer_chains/{phase}`

## Request

- Base URL: `https://api.mantrachain.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mantrachain.io/interchain_security/ccv/provider/consumer_chains/{phase}`
- Auth: none declared

## Path parameters

- `phase` 'CONSUMER_PHASE_UNSPECIFIED' | 'CONSUMER_PHASE_REGISTERED' | 'CONSUMER_PHASE_INITIALIZED' | 'CONSUMER_PHASE_LAUNCHED' | 'CONSUMER_PHASE_STOPPED' | 'CONSUMER_PHASE_DELETED', required

## Query parameters

- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- object
  - `chains` object[]
    - `chain_id` string
    - `client_id` string
    - `top_N` integer
    - `min_power_in_top_N` string, int64: If the chain is a Top-N chain, this is the minimum power required to be in the top N. Otherwise, this is -1.
    - `validators_power_cap` integer: Corresponds to the maximum power (percentage-wise) a validator can have on the consumer chain.
    - `validator_set_cap` integer: Corresponds to the maximum number of validators that can validate a consumer chain. Only applicable to Opt In chains. Setting `validator_set_cap` on a Top N chain is a no-op.
    - `allowlist` string[]: Corresponds to a list of provider consensus addresses of validators that are the ONLY ones that can validate the consumer chain.
    - `denylist` string[]: Corresponds to a list of provider consensus addresses of validators that CANNOT validate the consumer chain.
    - `phase` string
    - `metadata` object
      - `name` string
      - `description` string
      - `metadata` string
    - `min_stake` string, uint64: Corresponds to the minimal amount of (provider chain) stake required to validate on the consumer chain.
    - `allow_inactive_vals` boolean: Corresponds to whether inactive validators are allowed to validate the consumer chain.
    - `consumer_id` string
    - `allowlisted_reward_denoms` object
      - `denoms` string[]
    - `prioritylist` string[]: Corresponds to a list of provider consensus addresses of validators that should have PRIORITY to validate on the consumer chain, meaning as long as they are eligible/opted in to validate on the consumer chain, the validator set will be filled with these validators first, and other validators will be added to the validator set only if there are not enough eligible priority validators.
    - `infraction_parameters` object
      - `double_sign` object
        - `slash_fraction` string, byte
        - `jail_duration` string
        - `tombstone` boolean
      - `downtime` object
        - `slash_fraction` string, byte
        - `jail_duration` string
        - `tombstone` boolean
  - `pagination` object: PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte: next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/mantrachain/apis/mantra-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/mantrachain/apis/mantra-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/mantrachain/apis/mantra-grpc-gateway-docs/revisions/641ce457f7fd?raw)