---
title: "Create a withdrawal"
method: POST
path: "/v1beta/accounts/{account_id}/funding_wallet/withdrawal"
tags: ["Funding Wallets"]
---

# Create a withdrawal

`POST /v1beta/accounts/{account_id}/funding_wallet/withdrawal`

Creates a withdrawal

## Path parameters

- `account_id` string, required

## Request body

- CreateFundingWalletWithdrawalRequest
  - `desired_currency` string
  - `payment_type` 'swift_wire' | 'local_rails' — Status: * `swift_wire`: SWIFT wire * `local_rails`: Local scheme
  - `usd_amount` string, decimal

## Response `200`

Transfer

- FundingWalletTransfer
  - `account_id` string, uuid
  - `created_at` string, date-time
  - `direction` 'incoming' | 'outgoing' — Status: * `incoming`: incoming amount * `outgoing`: outgoing amount
  - `fees` TransferFee[]
    - `amount` string, decimal, required
    - `currency` string, required — "USD" // US Dollar "JPY" // Japanese Yen "EUR" // Euro "CAD" // Canadian Dollar "GBP" // British Pound Sterling "CHF" // Swiss Franc "TRY" // Turkish Lira "AUD" // Australian Dollar "CZK" // Czech Koruna "SEK" // Swedish Krona "DKK" // Danish Krone "SGD" // Singapore Dollar "HKD" // Hong Kong Dollar "HUF" // Hungarian Forint "NZD" // New Zealand Dollar "NOK" // Norwegian Krone "PLN" // Poland Złoty
    - `payment_type` 'invoice', required — Status: * `invoice`
    - `type` 'withdrawal_fee' | 'fx_fee' | 'network_fee' | 'deposit_fee' | 'ach_return_fee' | 'parnter_fee' | 'alpaca_fee', required — Status: * `withdrawal_fee`: Withdrawal fee * `fx_fee`: FX Fee * `network_fee` * `deposit_fee` * `ach_return_fee` * `parnter_fee` * `alpaca_fee`
  - `id` string, uuid
  - `original_amount` string, decimal — The amount you should expect to receive, calculated as requested amount - fees
  - `original_currency` string — The currency of the withdrawn amount, 3-letter ISO code
  - `payment_type` 'swift_wire' | 'local_rails' — Status: * `swift_wire`: SWIFT wire * `local_rails`: Local scheme
  - `requested_amount` string, decimal — The amount sent as part of the withdrawal creation
  - `status` 'PENDING' | 'CANCELED' | 'EXECUTED' | 'FAILED' | 'COMPLETE' — Status: * `PENDING`: Created and waiting to be processed * `CANCELED`: Canceled * `FAILED`: Failed mostly due to technical reasons * `COMPLETE`: Transfer has settled
  - `updated_at` string, date-time
  - `usd` Usd
    - `amount` string, decimal, required

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)