# /bridge/transfers

{% hint style="info" %}
You need an API key for this call.\
\
Please reach out to the Blessnet team to get setup.
{% endhint %}

<mark style="color:green;">`GET`</mark> `/bridge/transfers`

The `/bridge/transfers` endpoint returns bridge transfers that match the passed parameters. Results are paginated, with the default page size being 50 records.

### **Headers**

| Name        | Value        |
| ----------- | ------------ |
| `x-api-key` | Your API key |

### **Params**

<table><thead><tr><th width="215">Name</th><th width="130">Mandatory?</th><th width="119">Default</th><th>Value</th></tr></thead><tbody><tr><td><code>chain</code></td><td>No</td><td><code>mainnet</code></td><td>The chain type we are working with, either <code>mainnet</code> or <code>sepolia</code></td></tr><tr><td><code>fromChains</code></td><td>No</td><td></td><td>A comma separated list of the chain that the transfer must be from, e.g. 11155111,421614</td></tr><tr><td><code>toChains</code></td><td>No</td><td></td><td>A comma separated list of the chain that the transfer must be to, e.g. 11155111,421614</td></tr><tr><td><code>types</code></td><td>No</td><td></td><td>A comma separated list of the transfer types to look for, e.g. BLESS, ERC20.<br><br>Possible values:<br>- BLESS<br>- ERC20<br>- ERC721<br>- ERC1155<br>- TXN</td></tr><tr><td><code>address</code></td><td>No</td><td></td><td>A specific address, only records that match this address as the from or to address will be returned.</td></tr><tr><td><code>from_timestamp</code></td><td>No</td><td></td><td>Only records where the origin transaction timestamp is at or after this timestamp will be returned.</td></tr><tr><td><code>to_timestamp</code></td><td>No</td><td></td><td>Only records where the origin transaction timestamp is at or before this timestamp will be returned.</td></tr><tr><td><code>page_size</code></td><td>No</td><td><code>50</code></td><td>The number of records to return per page.</td></tr><tr><td><code>cursor</code></td><td>No</td><td><code>null</code></td><td>The cursor representing the start point of the next page of results.</td></tr></tbody></table>

### **Response Body**

The response provides an array of `bridgeData` objects with a single `nextCursor` value providing the cursor for the next page. If this is null there is no next page.

The `bridgeData` objects have the following properties:

<table><thead><tr><th width="247">Name</th><th width="114">Type</th><th width="389">Description</th></tr></thead><tbody><tr><td><code>_id</code></td><td><code>string</code></td><td>The unique Id for this transfer</td></tr><tr><td><code>type</code></td><td><code>string</code></td><td>The type of transfer, e.g. BLESS, ERC20.<br>Possible values:<br>- BLESS<br>- ERC20<br>- ERC721<br>- ERC1155<br>- TXN</td></tr><tr><td><code>status</code></td><td><code>string</code></td><td>The overall status of the transfer, including all nodes on the route.<br>Possible values:<br>done (transfer complete)<br>- wait-wh (awaiting wormhole completion.<br>- wait-rb (awaiting rollup bridge completion)<br>- wait-cc (awaiting child chain confirmation)<br>- manual (awaiting manual confirmation)<br>- error</td></tr><tr><td><code>fromChain</code></td><td><code>string</code></td><td>The origin chain.</td></tr><tr><td><code>toChain</code></td><td><code>string</code></td><td>The destination chain.</td></tr><tr><td><code>fromAddress</code></td><td><code>string</code></td><td>The address that has initiated the transfer.</td></tr><tr><td><code>toAddress</code></td><td><code>string</code></td><td>The address the transfer is going to.</td></tr><tr><td><code>originTimestamp</code></td><td><code>number</code></td><td>The timestamp from the first transaction in this transfer.</td></tr><tr><td><code>blessAmount</code></td><td><code>string</code></td><td>The amount of BLESS being send, if this is a BLESS transfer.</td></tr><tr><td><code>tokenContract</code></td><td><code>string</code></td><td>The address of the contract for the token being send, if this is a token transfer.</td></tr><tr><td><code>tokenAmount</code></td><td><code>string</code></td><td>The amount of token being sent, if this is a token transfer.</td></tr><tr><td><code>tokenIds</code></td><td><code>array</code></td><td>An array of the token Ids being sent, if this is an ERC721 or ERC1155 transfer.</td></tr><tr><td><code>originTxnHash</code></td><td><code>string</code></td><td>The transaction hash of the first transaction in this transfer.</td></tr><tr><td><code>whTxnHash</code></td><td><code>string</code></td><td>The transaction hash of this transfer being submitted to wormhole (will only be present if wormhole is used in the route).</td></tr><tr><td><code>rbTxnHash</code></td><td><code>string</code></td><td>The transaction hash of this transfer being submitted to the rollup bridge (will only be present if the rollup bridge is used in this route).</td></tr><tr><td><code>deliveryTxnHash</code></td><td><code>string</code></td><td>The transaction hash of this transfer being delivered to the destination chain.</td></tr><tr><td><code>route</code></td><td><code>array</code></td><td>An array of objects describing the route of this transaction and the hashes at each step, if that step has been completed.</td></tr></tbody></table>

### **Example Request**

<pre><code><strong>GET https://api.bless.net/bridge/transfers?chain=sepolia
</strong></code></pre>

### **Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "bridgeData": [
        {
            "_id": "67b6cec1cf1e3ed71398d6d5",
            "type": "ERC721",
            "chainType": "sepolia",
            "status": "wait-wh",
            "fromChain": 11155111,
            "toChain": 11145513,
            "fromAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "toAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "originTimestamp": 1740033684,
            "tokenContract": "0xB70B1bF56A66B65CCb32d3AF0CDC69150E16085f",
            "tokenIds": [
                "18",
                "17",
                "11"
            ],
            "originTxnHash": "0x4982035e643f0fd29d38114e2b95c8ff670db5268a4f2fdae0f4447386b70555",
            "whTxnHash": "0x4982035e643f0fd29d38114e2b95c8ff670db5268a4f2fdae0f4447386b70555",
            "route": [
                {
                    "step": 11155111,
                    "txHash": "0x4982035e643f0fd29d38114e2b95c8ff670db5268a4f2fdae0f4447386b70555"
                },
                {
                    "step": "wormhole",
                    "txHash": "0x4982035e643f0fd29d38114e2b95c8ff670db5268a4f2fdae0f4447386b70555"
                },
                {
                    "step": 421614,
                    "txHash": null
                },
                {
                    "step": "rollup-bridge",
                    "txHash": null
                },
                {
                    "step": 11145513,
                    "txHash": null
                }
            ]
        },
        {
            "_id": "67b6c958cf1e3ed713982d77",
            "type": "ERC20",
            "chainType": "sepolia",
            "status": "done",
            "fromChain": 11155111,
            "toChain": 11145513,
            "fromAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "toAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "originTimestamp": 1740032292,
            "tokenContract": "0xaF5a391579CA5D05e388a333c3D7e2823Ab3Ff7e",
            "tokenAmount": "1000000000000000000",
            "originTxnHash": "0xee9f46f0ec3d4b7955253bc00fdd5592e751035c07b57e6581c6d8533c173425",
            "rbTxnHash": "0x3f9b363dd7f1ee7413d66f3451402e412a23472661904e358973d843eabbea8a",
            "whTxnHash": "0xee9f46f0ec3d4b7955253bc00fdd5592e751035c07b57e6581c6d8533c173425",
            "deliveryTxnHash": "0xd8a3d794b56b42192f7e3c2933458da830622e77683ebe85de7d56e146a1b69c",
            "route": [
                {
                    "step": 11155111,
                    "txHash": "0xee9f46f0ec3d4b7955253bc00fdd5592e751035c07b57e6581c6d8533c173425"
                },
                {
                    "step": "wormhole",
                    "txHash": "0xee9f46f0ec3d4b7955253bc00fdd5592e751035c07b57e6581c6d8533c173425"
                },
                {
                    "step": 421614,
                    "txHash": "0x3f9b363dd7f1ee7413d66f3451402e412a23472661904e358973d843eabbea8a"
                },
                {
                    "step": "rollup-bridge",
                    "txHash": "0x3f9b363dd7f1ee7413d66f3451402e412a23472661904e358973d843eabbea8a"
                },
                {
                    "step": 11145513,
                    "txHash": "0xd8a3d794b56b42192f7e3c2933458da830622e77683ebe85de7d56e146a1b69c"
                }
            ]
        },
        {
            "_id": "67b6c377cf1e3ed713977528",
            "type": "ERC20",
            "chainType": "sepolia",
            "status": "done",
            "fromChain": 11155111,
            "toChain": 11145513,
            "fromAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "toAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "originTimestamp": 1740030816,
            "tokenContract": "0xE9A4f9ED03F656d1Df6A7e44b0D7C93a96AdD5A2",
            "tokenAmount": "1000000000000000000",
            "originTxnHash": "0xde5518baf1bf6e6fafbdd194ef4377b61816a9754618d791ac9d4effad1015b7",
            "rbTxnHash": "0x521e5d29b5abb9d789c337cda930e228e2481c13b3a7f8a84363f7b5cbf4c590",
            "whTxnHash": "0xde5518baf1bf6e6fafbdd194ef4377b61816a9754618d791ac9d4effad1015b7",
            "deliveryTxnHash": "0xdf8f882b49b675474cf504d55f86647b11fb0e09cd4497c6b87128c215d52652",
            "route": [
                {
                    "step": 11155111,
                    "txHash": "0xde5518baf1bf6e6fafbdd194ef4377b61816a9754618d791ac9d4effad1015b7"
                },
                {
                    "step": "wormhole",
                    "txHash": "0xde5518baf1bf6e6fafbdd194ef4377b61816a9754618d791ac9d4effad1015b7"
                },
                {
                    "step": 421614,
                    "txHash": "0x521e5d29b5abb9d789c337cda930e228e2481c13b3a7f8a84363f7b5cbf4c590"
                },
                {
                    "step": "rollup-bridge",
                    "txHash": "0x521e5d29b5abb9d789c337cda930e228e2481c13b3a7f8a84363f7b5cbf4c590"
                },
                {
                    "step": 11145513,
                    "txHash": "0xdf8f882b49b675474cf504d55f86647b11fb0e09cd4497c6b87128c215d52652"
                }
            ]
        },
        {
            "_id": "67b669e4cf1e3ed7138c7531",
            "type": "ERC20",
            "chainType": "sepolia",
            "status": "done",
            "fromChain": 11155111,
            "toChain": 11145513,
            "fromAddress": "0x5aa6b0ea75ec0acea067d0b00a81a231a8c7e3f6",
            "toAddress": "0x5aa6b0ea75ec0acea067d0b00a81a231a8c7e3f6",
            "originTimestamp": 1739961084,
            "tokenContract": "0xf39E178bE11b07901DD0B2FAd9DEfbc0109F8e2c",
            "tokenAmount": "1001000000000000000000",
            "originTxnHash": "0x819064a39c9ccd5ff38a8a740df951486548a6f045c53742cbddb7e0a4a65aef",
            "rbTxnHash": "0x7f4ab11eb340bbc95b7822485d31de22deb1536921591c267090eb18023bee31",
            "whTxnHash": "0x819064a39c9ccd5ff38a8a740df951486548a6f045c53742cbddb7e0a4a65aef",
            "deliveryTxnHash": "0x9386a45a48183c755434d37ceed8e509115b49f5777f71fea237b4bfdfe6d7bb",
            "route": [
                {
                    "step": 11155111,
                    "txHash": "0x819064a39c9ccd5ff38a8a740df951486548a6f045c53742cbddb7e0a4a65aef"
                },
                {
                    "step": "wormhole",
                    "txHash": "0x819064a39c9ccd5ff38a8a740df951486548a6f045c53742cbddb7e0a4a65aef"
                },
                {
                    "step": 421614,
                    "txHash": "0x7f4ab11eb340bbc95b7822485d31de22deb1536921591c267090eb18023bee31"
                },
                {
                    "step": "rollup-bridge",
                    "txHash": "0x7f4ab11eb340bbc95b7822485d31de22deb1536921591c267090eb18023bee31"
                },
                {
                    "step": 11145513,
                    "txHash": "0x9386a45a48183c755434d37ceed8e509115b49f5777f71fea237b4bfdfe6d7bb"
                }
            ]
        },
        {
            "_id": "67b668f3cf1e3ed7138c575d",
            "type": "ERC20",
            "chainType": "sepolia",
            "status": "done",
            "fromChain": 11155111,
            "toChain": 421614,
            "fromAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "toAddress": "0xa401e83732d64d869003670eda79ecdf101d7380",
            "originTimestamp": 1739960856,
            "tokenContract": "0xaF5a391579CA5D05e388a333c3D7e2823Ab3Ff7e",
            "tokenAmount": "1000000000000000000",
            "originTxnHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76",
            "whTxnHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76",
            "deliveryTxnHash": "0xd870621d41463c57e78ab4435c55661894268401ad21b1fcbf70d6110376591b",
            "route": [
                {
                    "step": 11155111,
                    "txHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76"
                },
                {
                    "step": "wormhole",
                    "txHash": "0x539599ca8ba1d3217c883137c7bde9a44f10d204747c09cfff20d2f80117ea76"
                },
                {
                    "step": 421614,
                    "txHash": "0xd870621d41463c57e78ab4435c55661894268401ad21b1fcbf70d6110376591b"
                }
            ]
        }
    ],
    "nextCursor": null
}
```

{% endtab %}
{% endtabs %}