---
title: "Connections queries all the IBC connections of a chain."
method: GET
path: "/ibc/core/connection/v1/connections"
tags: ["Query"]
---

# Connections queries all the IBC connections of a chain.

`GET /ibc/core/connection/v1/connections`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/coreumfoundation/apis/title-goes-here/docs/ibc/core/connection/v1/connections/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.

- IbcCoreConnectionV1QueryConnectionsResponse: QueryConnectionsResponse is the response type for the Query/Connections RPC method.
  - `connections` IbcCoreConnectionV1IdentifiedConnection[]: list of stored connections of the chain.
    - `id` string: connection identifier.
    - `client_id` string: client associated with this connection.
    - `versions` IbcCoreConnectionV1Version[]
      - `identifier` string
      - `features` string[]
    - `state` 'STATE_UNINITIALIZED_UNSPECIFIED' | 'STATE_INIT' | 'STATE_TRYOPEN' | 'STATE_OPEN': State defines if a connection is in one of the following states: INIT, TRYOPEN, OPEN or UNINITIALIZED. - STATE_UNINITIALIZED_UNSPECIFIED: Default State - STATE_INIT: A connection end has just started the opening handshake. - STATE_TRYOPEN: A connection end has acknowledged the handshake step on the counterparty chain. - STATE_OPEN: A connection end has completed the handshake.
    - `counterparty` IbcCoreConnectionV1Counterparty: Counterparty defines the counterparty chain associated with a connection end.
      - `client_id` string: identifies the client on the counterparty chain associated with a given connection.
      - `connection_id` string: identifies the connection end on the counterparty chain associated with a given connection.
      - `prefix` IbcCoreCommitmentV1MerklePrefix
        - `key_prefix` string, byte
    - `delay_period` string, uint64: delay period associated with this connection.
  - `pagination` CosmosBaseQueryV1beta1PageResponse: 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
  - `height` IbcCoreClientV1Height: Normally the RevisionHeight is incremented at each height while keeping RevisionNumber the same. However some consensus algorithms may choose to reset the height in certain conditions e.g. hard forks, state-machine breaking changes In these cases, the RevisionNumber is incremented so that height continues to be monitonically increasing even as the RevisionHeight gets reset
    - `revision_number` string, uint64
    - `revision_height` string, uint64

## Other responses

- `default`: An unexpected error response.

## Changes

- **2024-08-08** `785dbd465042`: 1 info
  - api operation id `GithubComCosmosIbcGoV7ModulesCore03ConnectionTypesConnections` removed and replaced with `GithubComCosmosIbcGoV8ModulesCore03ConnectionTypesConnections`
- **2023-09-11** `aaa274f20b71`: 1 info
  - api operation id `GithubComCosmosIbcGoV8ModulesCore03ConnectionTypesConnections` removed and replaced with `GithubComCosmosIbcGoV7ModulesCore03ConnectionTypesConnections`

[Operation history](https://skmtc.dev/coreumfoundation/apis/title-goes-here/changes/ibc/core/connection/v1/connections/get.md)

---

[API](https://skmtc.dev/coreumfoundation/apis/title-goes-here.md) - [All operations](https://skmtc.dev/coreumfoundation/apis/title-goes-here/llms.txt) - [OpenAPI document](https://skmtc.dev/coreumfoundation/apis/title-goes-here/revisions/2a2e5bc4593a?raw)