Skip to main content
Version: v2

CCIP API

REST API for querying cross-chain message data, lane information, and intent operations on the Chainlink Cross-Chain Interoperability Protocol.

Version2.0.0
FormatJSON
LicenseMIT

Multi-Chain Support

The CCIP API supports querying messages and lanes across multiple blockchain ecosystems:

Supported chain families:
EVM iconEVMSolana iconSolanaAptos iconAptos

Quick Reference

Use CaseEndpointAction
Track a cross-chain messageRetrieve a MessageTry it live →
Check lane performanceGet Lane LatencyTry it live →
Get a quote for intent transferGet Intent QuoteTry it live →
Find intents by transactionGet Intents by Tx HashTry it live →
Track intent statusGet Intent by IDTry it live →

Each endpoint page includes:

  • Full request/response schema
  • Code samples in 9 languages
  • Interactive playground to test live

HTTP Status Codes

All endpoints return standardized HTTP status codes:

CodeMeaning
200Success - request completed successfully
400Bad Request - invalid parameters or malformed request
404Not Found - resource does not exist (message ID, intent ID)
500Server Error - internal error, retry with exponential backoff
Bash
# Example: Check response status in scripts
curl -s -o /dev/null -w "%{http_code}" \
"https://api.ccip.chain.link/v2/message/0x..."

Authentication

Most CCIP API endpoints are publicly accessible and do not require authentication. However, Intent-related endpoints may require an x-api-key header for validation. Please be mindful of rate limits when integrating into production applications.

Next Steps