Retrieve multiple messages with filtering
GET/messages
Search and filter CCIP messages with cursor-based pagination. Results are ordered by send time (most recent first).
Use Cases:
- Search messages by sender or receiver address
- Filter messages by source or destination chain
- Find messages ready for manual execution
- Look up messages by source transaction hash
Search Parameter Constraints
- You can use either cursor OR filter parameters (sender, receiver, sourceChainSelector, destChainSelector, readyForManualExecOnly, sourceTransactionHash), but NOT both simultaneously.
- limit can always be specified regardless of whether you're using cursor or filters.
- Violating constraints will return a 400 Bad Request.
Usage Examples:
- Initial filtered search:
/messages?sender=0x123...&limit=50 - Next page with cursor:
/messages?cursor=WyJuYXR1cmFsIiwxMjM0NV0=&limit=20 - Invalid (returns 400):
/messages?sender=0x123...&cursor=WyJuYXR1cmFsIiwxMjM0NV0=
Request
Responses
- 200
- 400
- 500
The request was successful. Returns an array of MessageSearchResult objects with pagination metadata.
Response Headers
X-Request-ID
Unique request identifier for debugging and support
Bad request - Invalid parameter format or constraint violation. Returns an Error object.
Response Headers
X-Request-ID
Unique request identifier for debugging and support
Internal server error. Returns an Error object.
Response Headers
X-Request-ID
Unique request identifier for debugging and support