# transferbatch-v1

Initiate a transfer request (between subaccounts or another account holder), view or act upon pending transfers, as well as view historical transfer details.

## Initiate counterparty transfer

 - [POST /api/ledger/{ledgerIdentifier}/transfer](https://developer.xpansiv.com/openapi/optimal-v1/optimal.transferposition.v1.openapi/transferbatch-v1/initiateaccounttransfers.md): Initiate transfer will propose the transaction to the counterparty, after which the counterparty will be prompted to act on the proposal.

## Act on a proposed transfer

 - [POST /api/ledger/{ledgerIdentifier}/transferBatch/open/action](https://developer.xpansiv.com/openapi/optimal-v1/optimal.transferposition.v1.openapi/transferbatch-v1/acknowledgetransferbatches.md): Actions include accept, reject or withdrawal of a proposed transfer, using the transfer batch identifier.

## Retrieve transfer request details

 - [POST /api/ledger/{ledgerIdentifier}/transferBatch/byIdentifier](https://developer.xpansiv.com/openapi/optimal-v1/optimal.transferposition.v1.openapi/transferbatch-v1/gettransferbatchesbyidentifier.md): View the details behind a transfer request, using the transfer batch identifier.

## Transfer holdings between subaccounts

 - [POST /api/ledger/{ledgerIdentifier}/transfer/subaccount](https://developer.xpansiv.com/openapi/optimal-v1/optimal.transferposition.v1.openapi/transferbatch-v1/initiatesubaccounttransfers.md): Transfers holdings between active subaccounts, within the same account.

## Retrieve pending transfer requests

 - [GET /api/ledger/{ledgerIdentifier}/transferBatch/open](https://developer.xpansiv.com/openapi/optimal-v1/optimal.transferposition.v1.openapi/transferbatch-v1/getopentransferbatches.md): Retrieve list of currently pending transfers.