# 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>.
