API Reference

Get messages and attestations

gethttps://iris-api-sandbox.circle.com/v2/messages/{sourceDomainId}

  • Reference
  • Playground

Retrieves messages and attestations for a given transaction or nonce, supporting both V1 and V2 messages.

Path parameters
sourceDomainId
string
Required

The source domain ID associated with the messages.

Query parameters
transactionHash
string

The transaction hash to filter messages. At least one of transactionHash or nonce is required.

nonce
string

The nonce to filter messages. At least one of transactionHash or nonce is required.

Response
RequestChoose a language
ResponseChoose an example
1{
2  "messages": [
3    {
4      "message": "0x0123456789abcdef",
5      "eventNonce": "0xabc123def456",
6      "attestation": "0xfee987eedcb",
7      "decodedMessage": {
8        "sourceDomain": 3,
9        "destinationDomain": 4,
10        "nonce": "0xabc123def456",
11        "sender": "0x456",
12        "recipient": "0x789",
13        "destinationCaller": "0x012",
14        "messageBody": "0x234",
15        "decodedMessageBody": {
16          "burnToken": "0x345",
17          "mintRecipient": "0x678",
18          "amount": 5000,
19          "messageSender": "0x901"
20        }
21      },
22      "cctpVersion": 1,
23      "status": "complete"
24    },
25    {
26      "message": "0xabcdef1234567890",
27      "eventNonce": "0x9876543343",
28      "attestation": "0x48348ca84e",
29      "decodedMessage": {
30        "sourceDomain": 0,
31        "destinationDomain": 1,
32        "nonce": "0x9876543343",
33        "sender": "0x456",
34        "recipient": "0x789",
35        "destinationCaller": "0x012",
36        "minFinalityThreshold": 2000,
37        "finalityThresholdExecuted": 2000,
38        "messageBody": "0x234",
39        "decodedMessageBody": {
40          "burnToken": "0x345",
41          "mintRecipient": "0x678",
42          "amount": 10000,
43          "messageSender": "0x901",
44          "maxFee": 5,
45          "feeExecuted": 1,
46          "expirationBlock": 9001,
47          "hookData": "0x234"
48        }
49      },
50      "cctpVersion": 2,
51      "status": "complete"
52    }
53  ]
54}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.