> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anchorage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Withdraw

> Send USD out of a customer's virtual account with the Transfers API.

To send USD on behalf of a customer, create a transfer from your FBO wallet and attribute it to the customer's virtual account with its `virtualAccountId`. You need an API key with the **Transfer funds** permission, and the request must carry an Ed25519 signature. See [Request signing](https://docs.anchorage.com/knowledge-base/platform/developers/request-signing.md).

> [!NOTE]
>
> Staging uses the `USD_R` asset type and `https://api.anchorage-staging.com/v2`. Production uses `USD` and `https://api.anchorage.com/v2`. The example below shows the staging value.

## Create a transfer from a virtual account

**`POST /v2/transfers`**

Set `source.type` to `WALLET`, `source.id` to your FBO wallet's ID, and `source.virtualAccountId` to the virtual account the withdrawal belongs to. Set `destination.type` to `TRUSTED_DESTINATION` and `destination.id` to a USD trusted destination, and include `assetParametersFiatTrustedDestination`. See [Create a transfer request](https://docs.anchorage.com/knowledge-base/api-reference/v2/transfers/create-a-transfer-request.md) for the full reference.

To pay out to your customer's bank account, add it as a USD trusted destination first. To move funds to another virtual account, see [Transfer to another virtual account](#transfer-to-another-virtual-account).

```bash Request theme={null}
curl --request POST \
     --url 'https://api.anchorage-staging.com/v2/transfers' \
     --header 'Api-Access-Key: [API Key]' \
     --header 'Api-Signature: [Signature]' \
     --header 'Api-Timestamp: [Timestamp]' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
       "source": {
         "id": "[FBO Wallet ID]",
         "type": "WALLET",
         "virtualAccountId": "[Virtual Account ID]"
       },
       "destination": {
         "id": "[USD Trusted Destination ID]",
         "type": "TRUSTED_DESTINATION"
       },
       "assetType": "USD_R",
       "amount": "1000.00",
       "idempotentId": "[Unique ID]",
       "transferMemo": "[Memo]",
       "assetParametersFiatTrustedDestination": {
         "purpose": "[Purpose]"
       }
     }'
```

```json Response theme={null}
{
  "data": {
    "transferId": "[Transfer ID]",
    "status": "QUEUED"
  }
}
```

### Fields

| Field | Description |
| :- | :- |
| `source.id` | Your FBO wallet's ID. |
| `source.type` | `WALLET`. |
| `source.virtualAccountId` | The virtual account the withdrawal is attributed to. |
| `destination.id` | A USD trusted destination ID. |
| `destination.type` | `TRUSTED_DESTINATION`. |
| `assetType` | `USD_R` in staging, `USD` in production. |
| `amount` | USD amount as a string. |
| `idempotentId` | Required. A unique ID you generate, so a retried request doesn't send the transfer twice. |
| `transferMemo` | Optional description attached to the transfer. |
| `assetParametersFiatTrustedDestination.purpose` | Required. The reason for the transfer. See the [domestic wire transfer](https://docs.anchorage.com/knowledge-base/platform/developers/move-money/transfer/usd/wire/domestic.md#purpose-values) page for the allowed values. |

We don't track a balance for each virtual account, so we can't stop a withdrawal that exceeds what your customer holds. Check the customer's balance on your own ledger before you submit the transfer.

## Transfer to another virtual account

To move USD to another virtual account, set `destination.type` to `WALLET`, `destination.id` to the destination wallet's ID, and `destination.virtualAccountId` to the receiving virtual account. Leave out `assetParametersFiatTrustedDestination`.

```json Request body theme={null}
{
  "source": {
    "id": "[FBO Wallet ID]",
    "type": "WALLET",
    "virtualAccountId": "[Source Virtual Account ID]"
  },
  "destination": {
    "id": "[Destination Wallet ID]",
    "type": "WALLET",
    "virtualAccountId": "[Destination Virtual Account ID]"
  },
  "assetType": "USD_R",
  "amount": "1000.00",
  "idempotentId": "[Unique ID]"
}
```

## Track the transfer

Transfers are queued and processed in the order we receive them. Check a transfer's status with [Get transfer by ID](https://docs.anchorage.com/knowledge-base/api-reference/v2/transfers/get-transfer-by-id.md), or subscribe to [webhooks](https://docs.anchorage.com/knowledge-base/platform/developers/webhooks/webhooks-overview.md) instead of polling. To list transfers for one virtual account, call `GET /v2/transfers` with the `virtualAccountId` query parameter, or with `customerId` for every virtual account a customer owns.


## Related topics

- [Crypto withdrawal](https://docs.anchorage.com/knowledge-base/porto/developers/move-money/withdraw/crypto.md)
- [International wire withdrawal](https://docs.anchorage.com/knowledge-base/platform/developers/move-money/withdraw/usd/wire/international.md)
- [Domestic wire withdrawal](https://docs.anchorage.com/knowledge-base/platform/developers/move-money/withdraw/usd/wire/domestic.md)
- [ACH credit withdrawal](https://docs.anchorage.com/knowledge-base/platform/developers/move-money/withdraw/usd/ach/credit.md)
- [Internal withdrawals](https://docs.anchorage.com/knowledge-base/platform/developers/move-money/withdraw/usd/internal.md)
