---
title: "Retrieve CCIP lane information"
method: GET
path: "/lanes"
tags: ["lanes"]
---

# Retrieve CCIP lane information

`GET /lanes`

Returns information about Cross-Chain Interoperability Protocol (CCIP) lanes between supported chains. Each lane represents a unidirectional connection from a source chain to a destination chain, with associated onRamp and offRamp contracts and supported tokens.

## Query parameters

- `environment` 'mainnet' | 'testnet', required
- `sourceChainId` string
- `destinationChainId` string
- `sourceSelector` string
- `destinationSelector` string
- `sourceInternalId` string
- `destinationInternalId` string
- `version` string
- `outputKey` 'chainId' | 'selector' | 'internalId'

## Response `200`

Successful response with lane data

- LaneApiResponse
  - `metadata` LaneMetadata, 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
    - `ignoredLaneCount` integer, required — Number of lanes ignored due to configuration issues
    - `validLaneCount` integer, required — Number of valid lanes in the response
  - `data` object, required — Lane data organized by dynamic lane keys (e.g., '1_to_56', 'ethereum-mainnet_to_polygon-mainnet')
  - `ignored` LaneConfigError[], required — List of lanes that could not be configured
    - `sourceChain` string, required — Source chain identifier that failed configuration
    - `destinationChain` string, required — Destination chain identifier that failed configuration
    - `reason` string, required — Human-readable reason for the configuration failure
    - `missingFields` string[], required — List of missing or invalid configuration fields

## Other responses

- `400` — Bad request - invalid parameters
- `500` — Internal server error

## Changes

- **2026-02-17** (v1) `7c63886b61d0` — 4 breaking, 2 info
  - removed the required property `data/additionalProperties/destinationChain/chainFamily` from the response with the `200` status
  - removed the required property `data/additionalProperties/destinationChain/chainType` from the response with the `200` status
  - removed the required property `data/additionalProperties/sourceChain/chainFamily` from the response with the `200` status
  - removed the required property `data/additionalProperties/sourceChain/chainType` from the response with the `200` status
  - …2 more
- **2025-09-16** (v1) `15f264d85455` — 1 info
  - endpoint added
- **2025-02-07** (v1) `1b317d8c0cde` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/smartcontractkit/apis/ccip-directory-and-configuration-rest-api-v1/changes/lanes/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)