# Create a new withdrawal

Endpoint: POST /withdrawals
Version: 1.0.0
Security: JWT

## Request fields (application/json):

  - `amount` (number, required)
    The amount you want to receive.
    Example: 1000

  - `balance_currency` (string, required)
    The balance which you want use to make the withdrawal. For example, USD. This is the currency in which the amount will be deducted from your balance. The target currency in which the amount will be settled will be the currency set in the withdrawal account.
    Example: "USD"

  - `withdrawal_account_id` (string)
    The unique identifier for the withdrawal account.
    Example: "accwith_5JU9yv0lGSUP"

## Response 201 fields (application/json):

  - `id` (string)
    The unique identifier for the withdrawal.
    Example: "payout_DdWpHUbOnlg"

  - `status` (string)
    The status of the withdrawal.
    Enum: "in_progress", "success", "failed", "action_required", "cancelled", "under_review"

  - `currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: "USD"

  - `amount` (number)
    The amount you want to receive in cents. For example, 1000 cents is $10.00.  The currency is determined by the currency field. Cents is a general  term for the smallest unit of currency in any currency. It does not  necessarily mean USD cents.
    Example: 1000

  - `withdrawal_account_id` (string)
    The unique identifier for the withdrawal account.
    Example: "accwith_5JU9yv0lGSUP"

  - `payment_method` (string)
    The payment method to use for the withdrawal.
    Enum: "bank_transfer"

  - `balance_used` (array)
    The amount in cents that was deducted from your balance for this withdrawal.

  - `balance_used.amount` (number)
    The balance amount in the smallest currency unit. For example, if the amount is $299.00, then 29900 is passed in  this field. In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990. And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295.
    Example: 1000

  - `purpose_code` (string)
    Purpose code for why you want to receive this payment
    Example: "S0017"

  - `mid_market_rate` (array)
    The mid-market rate at the time of withdrawal creation.

  - `mid_market_rate.rate` (number)
    The the conversion rate used for the currency(ies) for a given transaction.
    Example: 1.4

  - `fx_fees` (array)
    The FX fees applied to the withdrawal.

  - `txn_fees` (array)
    The transaction fees applied to the withdrawal.

  - `created_at` (string)
    Timestamp representing when the payin was created
    Example: "2021-06-01T12:00:00Z"

  - `updated_at` (string)
    Timestamp representing when the payin was last updated
    Example: "2021-06-01T12:00:00Z"