---
title: "Retrieve CCIP chain information"
method: GET
path: "/chains"
tags: ["chains"]
---

# Retrieve CCIP chain information

`GET /chains`

Returns information about Cross-Chain Interoperability Protocol (CCIP) chains across different blockchain families (EVM, Solana, Aptos)

## Query parameters

- `environment` 'mainnet' | 'testnet', required
- `chainId` string
- `selector` string
- `internalId` string
- `outputKey` 'chainId' | 'selector' | 'internalId'

## Response `200`

Successful response with chain data

- ChainApiResponse
  - `metadata` ChainMetadata, required
    - `environment` 'mainnet' | 'testnet', required — The network environment
    - `timestamp` string, date-time, required — ISO timestamp of the response
    - `requestId` string, uuid, required — Unique identifier for the request
    - `ignoredChainCount` integer, required — Number of chains ignored due to configuration issues
    - `validChainCount` integer, required — Number of valid chains in the response
  - `data` object, required — Chain details grouped by chain family
    - `evm` object — EVM chain details keyed by the specified output key
    - `svm` object — Solana VM chain details keyed by the specified output key
    - `mvm` object — Move VM (Aptos) chain details keyed by the specified output key
  - `ignored` ChainConfigError[], required — List of chains that could not be configured
    - `chainId` integer, required — Chain ID of the failed configuration
    - `networkId` string, required — Network identifier of the failed configuration
    - `reason` string, required — Reason for the configuration failure
    - `missingFields` string[], required — List of missing required fields

## Other responses

- `400` — Invalid request parameters
- `500` — Internal server error

## Changes

- **2025-05-19** (v1) `f253da0873ba` — 4 breaking, 10 info
  - the response property `data/evm` became optional for the status `200`
  - the response property `data/evm/additionalProperties/registryModule` became optional for the status `200`
  - the response property `data/evm/additionalProperties/tokenAdminRegistry` became optional for the status `200`
  - response property `data/evm/additionalProperties/chainId` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - …10 more
- **2025-03-06** (v1) `1d82b6bec1fa` — 1 info
  - added the optional property `data/evm/additionalProperties/tokenPoolFactory` to the response with the `200` status
- **2025-02-07** (v1) `1b317d8c0cde` — 4 breaking, 18 warning, 9 info
  - the `data/evm/additionalProperties/feeTokens` response's property type changed from no type to `array` for status `200`
  - removed the required property `data/evm/additionalProperties/chainFamily` from the response with the `200` status
  - removed the required property `data/evm/additionalProperties/chainType` from the response with the `200` status
  - removed the required property `data/evm/additionalProperties/supported` from the response with the `200` status
  - …27 more

[Change history](https://skmtc.dev/smartcontractkit/apis/ccip-directory-and-configuration-rest-api-v1/changes/chains/get.md)

---

[API](https://skmtc.dev/smartcontractkit/apis/ccip-directory-and-configuration-rest-api-v1.md) · [All operations](https://skmtc.dev/smartcontractkit/apis/ccip-directory-and-configuration-rest-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartcontractkit/ccip-directory-and-configuration-rest-api-v1/revisions/f253da0873ba/schema)