💸 Withdraw AUD

When you burn AUDD, the equivalent amount of Australian dollars (AUD) is credited to your Virtual Account balance. To complete the process, you’ll need to specify the external bank account where those funds should be withdrawn.

🚧

Bank Account Required:

Before you can initiate a withdrawal, the destination bank account must be added and approved in Mint. For setup instructions, see the External Bank Account Management guide.

💲 Withdrawing AUD

Withdrawals are made using the POST /bank-accounts/withdraw endpoint. This request tells the AUDD Mint how much AUD you’d like to withdraw, and which registered bank account it should be sent to. Request Body fields are defined as follows:

📤 Example Request:

curl -X POST [https://distributor-api-staging.audd.digital/bank-accounts/withdraw](https://distributor-api-staging.audd.digital/bank-accounts/withdraw)  
  -H "Authorization: Bearer <YOUR_API_KEY>"  
  -H "Content-Type: application/json"  
  -d '{  
    "srcBankAccountId": "<DEPOSIT_BANK_ACCOUNT_ID>",  
    "destBankAccountId": "<WITHDRAWAL_BANK_ACCOUNT_ID>",  
    "currency": "AUD",  
    "amount": 1 
  }'

📥 Example Response:

{
    "id": "withdraw id",
    "type": "WITHDRAWAL",
    "sourceBankAccount": {
        "id": "<deposit bank account public id>",
        "bsb": "",
        "accountNumber": "",
        "payId": null,
        "currency": "AUD",
        "balance": null,
        "type": "DISTRIBUTOR",
        "nickname": "<deposit bank account nickname>",
        "company": {
            "id": "<distributor company id>",
            "name": "<distributor company name>",
            "types": null
        },
        "subType": "DEPOSIT",
        "contactId": null,
        "providerType": "BANKING_CIRCLE",
        "status": "ACTIVE",
        "accountHolderName": "",
        "accountHolderFirstname": "",
        "accountHolderLastname": ""
    },
    "destinationBankAccount": {
        "id": "<withdrawal bank account id>",
        "bsb": "",
        "accountNumber": "",
        "payId": null,
        "currency": "AUD",
        "balance": null,
        "type": "DISTRIBUTOR",
        "nickname": "",
        "company": {
            "id": "<distributor company id>",
            "name": "<distributor company name>",
            "types": null
        },
        "subType": "WITHDRAWAL",
        "contactId": null,
        "providerType": "NONE",
        "status": "ACTIVE",
        "accountHolderName": null,
        "accountHolderFirstname": null,
        "accountHolderLastname": null
    },
    "amount": 1,
    "fee": 0.01,
    "currency": "AUD",
    "status": "IN_PROGRESS",
    "approver": null,
    "createdBy": {
        "id": "",
        "firstName": "",
        "lastName": "",
        "email": "",
        "phone": ""
    },
    "distributorCompany": {
        "id": "",
        "name": "",
        "types": null
    },
    "createdAt": "2025-09-05T07:39:00.689+00:00",
    "reference": "ZTLPAQO",
    "description": null,
    "bankTransactionId": null,
    "transactionId": null,
    "metadata": null,
    "refundTransactionId": null,
    "holdUntilDate": null,
    "adjustment": false,
    "privateAdjustment": false
}

❗️

Fees May Apply:

Withdrawal fees may be deducted automatically from the withdrawal amount, meaning the funds received will be the requested amount minus fees. For more details on how this is handled, refer to the Fees and Charges Guide.