---
title: "GetChains returns a list of chains (enabled only by default, or all if all=true)"
method: GET
path: "/blockchain/v1/chains"
tags: ["BlockchainQueryService"]
---

# GetChains returns a list of chains (enabled only by default, or all if all=true)

`GET /blockchain/v1/chains`

## Request

- Base URL: `https://backend.pay.kiichain.io`
- URL: `https://backend.pay.kiichain.io/blockchain/v1/chains`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Password
    - Token URL: `https://backend.pay.kiichain.io/users/v1/auth/login` scopes: `accounts.kyc.read`, `accounts.kyc.read:all`
- TypeScript: <https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend/docs/blockchain/v1/chains/get.ts> (a function with typed inputs; its response is checked against the schema)

Use GetChainByID instead when only one chain's details are needed

## Query parameters

- `all` boolean

## Response `200`

A successful response.

- ChainsGetChainsResponse
  - `chains` V1Chain[], required
    - `chainId` string, required
    - `confirmationDepth` integer, required
    - `contracts` object, required
    - `enabled` boolean, required
    - `feeAddress` string
    - `feeBps` integer
    - `id` integer, required
    - `logo` string, required
    - `name` string, required
    - `testnet` boolean, required
    - `type` string, required

## Other responses

- `default`: An unexpected error response. `details[0]` is always an AppError, see #/components/schemas/AppError

---

[API](https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend.md) - [All operations](https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend/revisions/8951249f5b63?raw)