---
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'
- `enrichFeeTokens` 'true' | 'false'
- `search` string
- `family` 'evm' | 'solana' | 'aptos' | 'sui' | 'tron' | 'canton' | 'ton' | 'stellar' | 'starknet'

## 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
    - `searchQuery` string — The search query that was used (only present when search parameter was provided)
    - `searchType` 'selector' | 'chainId' | 'internalId' | 'displayName' — The detected type of search query. 'selector' for CCIP selectors (>17 digits), 'chainId' for chain IDs (≤17 digits or Solana base58), 'internalId' for kebab-case identifiers, 'displayName' for fuzzy text search.
  - `data` object, required — Chain details grouped by chain family
    - `evm` object — EVM chain details keyed by the specified output key
    - `solana` object — Solana chain details keyed by the specified output key
    - `aptos` object — Aptos chain details keyed by the specified output key
    - `sui` object — Sui chain details keyed by the specified output key
    - `tron` object — Tron chain details keyed by the specified output key
    - `canton` object — Canton chain details keyed by the specified output key
    - `ton` object — TON chain details keyed by the specified output key
    - `stellar` object — Stellar chain details keyed by the specified output key
    - `starknet` object — Starknet 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

- **2026-02-17** (v1) `7c63886b61d0` — 16 warning, 18 info
  - removed the optional property `data/mvm` from the response with the `200` status
  - removed the optional property `data/svm` from the response with the `200` status
  - added the new `aptos` enum value to the `data/evm/additionalProperties/chainFamily` response property for the response status `200`
  - added the new `canton` enum value to the `data/evm/additionalProperties/chainFamily` response property for the response status `200`
  - …30 more
- **2025-10-13** (v1) `c10577435fe7` — 6 breaking, 1 info
  - added `subschema #1, subschema #2` to the `data/evm/additionalProperties/feeTokens` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/mvm/additionalProperties/feeTokens` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2` to the `data/svm/additionalProperties/feeTokens` response property `oneOf` list for the response status `200`
  - the `data/evm/additionalProperties/feeTokens` response's property type changed from `array` to no type for status `200`
  - …3 more
- …earlier changes not shown

[Full 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/313422bcca1a/schema)