# Link.batchNftTransfer

## Link.batchNftTransfer

As of `1.3.52`, the `@imtbl/imx-sdk` supports transferring large amounts of NFT assets in batches. To begin a new batch transfer flow, link should be called like so:

```
const response = await link.batchNftTransfer(payload);
```

Where the payload is of type `LinkParams.BatchNftTransfer`:

```
const payload: LinkParams.BatchNftTransfer = [
  {
    type: ERC721TokenType.ERC721, // Must be of type ERC721
    tokenId: string, // the token ID
    tokenAddress: string, // the collection address / contract address this token belongs to
    toAddress: string, // the wallet address this token is being transferred to
  },
  //...remainingTransfers
];
```

The response type is the same as <mark style="color:blue;">Link.transfer.</mark>

### Notes[​](https://docs.x.immutable.com/docs/x/linkbatchnfttransfer#notes) <a href="#notes" id="notes"></a>

* Requests will be batched in groups of **100** (This is the current batch size, it is subject to change, however this will not affect your implementation)
* Only tokens of type `ERC721TokenType.ERC721` can be used in `link.batchNftTransfer`
* If any validation errors are present in the current batch, the entire batch will not be performed
* If any API errors are received as part of processing the current batch, the entire batch will fail
* If any errors are present (due to validation, API or otherwise) for a particular batch, you will still be able progress to the next batch
* Each confirmation is accompanied by a signing process on the user wallet

### Screenshots from user journey[​](https://docs.x.immutable.com/docs/x/linkbatchnfttransfer#screenshots-from-user-journey) <a href="#screenshots-from-user-journey" id="screenshots-from-user-journey"></a>

![Confirm Transfer Batch](https://3017072639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7a6afyDwSEkvWtt1UhmH%2Fuploads%2Fv3BmAsgLJzqJKIVMGK7R%2F1%E5%A4%A7%E6%A0%87%E9%A2%98.png?alt=media\&token=c464ff94-d9e0-4340-819a-5975614fcff5)

![First Batch Complete](https://3017072639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7a6afyDwSEkvWtt1UhmH%2Fuploads%2FilCJPmDodB4XjOvOQPNi%2F2%E5%A4%A7%E6%A0%87%E9%A2%98.png?alt=media\&token=4feabb64-efd4-4731-a54c-ee747dfe79ce)

![All Batches Complete](https://3017072639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7a6afyDwSEkvWtt1UhmH%2Fuploads%2FGBxETfoarUOX3EH4vzbY%2F3%E5%A4%A7%E6%A0%87%E9%A2%98.png?alt=media\&token=c0aaf37b-7328-4ab8-9cf1-7b1db33a8ffe)

![Example Validation Error](https://3017072639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7a6afyDwSEkvWtt1UhmH%2Fuploads%2FMVZDZV5uSkiBVZUlRuh5%2F4%E5%A4%A7%E6%A0%87%E9%A2%98.png?alt=media\&token=1e594b27-10a8-4c2f-81d5-d4b742b94913)

### Errors[​](https://docs.x.immutable.com/docs/x/linkbatchnfttransfer#errors) <a href="#errors" id="errors"></a>

See error responses <mark style="color:blue;">here</mark>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xpansionchain-1.gitbook.io/xpansionchain/advanced-guides/link-sdk/link.batchnfttransfer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.