---
title: "Get a list of all chains"
method: GET
path: "/v1/chains"
tags: ["chains"]
---

# Get a list of all chains

`GET /v1/chains`

## Response `200`

A list of all available chains

- ChainInfoResponse[]
  - `chainID` string, string, required — ChainID (Bech32-encoded)
  - `chainOwnerId` string, string, required — The chain owner address (Bech32-encoded)
  - `evmChainId` integer, required — The EVM chain ID
  - `gasFeePolicy` FeePolicy, required
    - `evmGasRatio` Ratio32, required
      - `a` integer, required
      - `b` integer, required
    - `gasPerToken` Ratio32, required
      - `a` integer, required
      - `b` integer, required
    - `validatorFeeShare` integer, required — The validator fee share.
  - `gasLimits` Limits, required
    - `maxGasExternalViewCall` integer, required — The maximum gas per external view call
    - `maxGasPerBlock` integer, required — The maximum gas per block
    - `maxGasPerRequest` integer, required — The maximum gas per request
    - `minGasPerRequest` integer, required — The minimum gas per request
  - `isActive` boolean, required — Whether or not the chain is active
  - `metadata` PublicChainMetadata, required
    - `description` string, string, required — The description of the chain.
    - `evmJsonRpcURL` string, string, required — The EVM json rpc url
    - `evmWebSocketURL` string, string, required — The EVM websocket url)
    - `name` string, string, required — The name of the chain
    - `website` string, string, required — The official website of the chain.
  - `publicURL` string, string, required — The fully qualified public url leading to the chains metadata

## Other responses

- `401` — Unauthorized (Wrong permissions, missing token)

## Changes

- **2023-05-30** `c4ebd9663bfe` — 3 breaking, 2 info
  - removed the required property `items/evmJsonRpcUrl` from the response with the `200` status
  - removed the required property `items/evmWebSocketUrl` from the response with the `200` status
  - removed the required property `items/publicUrl` from the response with the `200` status
  - added the required property `items/metadata` to the response with the `200` status
  - …1 more
- **2023-05-25** `10110c47ba89` — 1 breaking
  - removed the required property `items/standard` from the response with the `200` status
- **2023-05-17** `55ceaf76774c` — 2 breaking, 3 info
  - removed the required property `items/metadataEvmJsonRpcUrl` from the response with the `200` status
  - removed the required property `items/metadataEvmWebSocketUrl` from the response with the `200` status
  - added the required property `items/evmJsonRpcUrl` to the response with the `200` status
  - added the required property `items/evmWebSocketUrl` to the response with the `200` status
  - …1 more
- **2023-05-16** `8ff59d94a1ae` — 1 warning, 3 info
  - removed the optional property `items/customMetadata` from the response with the `200` status
  - added the required property `items/metadataEvmJsonRpcUrl` to the response with the `200` status
  - added the required property `items/metadataEvmWebSocketUrl` to the response with the `200` status
  - added the required property `items/publicUrl` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/iotaledger/apis/wasp-api/changes/v1/chains/get.md)

---

[API](https://skmtc.dev/iotaledger/apis/wasp-api.md) · [All operations](https://skmtc.dev/iotaledger/apis/wasp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/iotaledger/wasp-api/revisions/992c016b4b67/schema)