---
title: "Withdraw Funds"
method: POST
path: "/wallet_accounts/{id}/withdraw"
tags: ["Wallet Accounts"]
---

# Withdraw Funds

`POST /wallet_accounts/{id}/withdraw`

Withdraw funds from a **Wallet Account** to a specified disbursement account.

## Path parameters

- `id` string, required

## Request body

- WithdrawRequestBody
  - `account_id` string, required — Account to withdraw to.
  - `amount` integer, required — Amount (in cents) to withdraw.
  - `custom_descriptor` string — A descriptor specified by the customer to be passed on the withdraw call. This requires that custom_descriptors are enabled. In the case of fast payments (AU / NPP) Assembly will append a value in the beginning of descriptor, the customer can use 200 characters (excluding URL, javascript/code, emojis). In the case of DE batch payments will allow 18 characters
  - `reference_id` string — Unique reference information that can be specified for a wallet withdrawal request. This is an optional field and cannot contain '.' character.

## Response `201`

OK

- SingleDisbursement
  - `disbursements` Disbursement
    - `id` string
    - `reference_id` string
    - `amount` integer
    - `currency` string
    - `batch_id` string
    - `cuscal_payment_transaction_id` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `state` string
    - `to` string
    - `bank_name` string
    - `bank_account_name` string
    - `bank_account_number` string
    - `bank_routing_number` string
    - `npp_payout_state` string
    - `account_name` string
    - `biller_name` string
    - `biller_code` string
    - `crn` string
    - `links` object
      - `transactions` string
      - `wallet_accounts` string
      - `paypal_accounts` string
      - `bank_accounts` string
      - `bpay_accounts` string
      - `items` string
      - `users` string

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/versions/60b528b2e015/schema)