---
title: "Create Fiat Withdrawal"
method: POST
path: "/transfer/fiat-withdrawals"
tags: ["Fiat Transfers"]
---

# Create Fiat Withdrawal

`POST /transfer/fiat-withdrawals`

Withdraw fiat to the given destination.

## Request body

- CreateFiatWithdrawalRequest
  - `ref_id` string — The optional client-specified ID (for idempotence).
  - `amount` string — Amount to withdraw, excluding fees. Specify exactly one of `amount` or `total`. When `amount` is specified, Paxos initiates the withdrawal for `amount` and then charges fees.
  - `asset` string, required — The asset to withdraw. Current supported asset: "USD".
  - `fiat_account_id` string, required — The fiat account (`fiat_account_id`) destination.
  - `profile_id` string, required — The Profile (`profile_id`) to withdraw from.
  - `identity_id` string — The Identity (`identity_id`) of the user making the withdrawal. Required only for customers with [3rd-Party integrations](https://docs.paxos.com/crypto-brokerage/ledger-type#fiat-and-crypto-subledger) initiating transfers on behalf of their end users.
  - `account_id` string — The Account (`account_id`) associated with the Identity of the user making the withdrawal. Required only for customers with [3rd-Party integrations](https://docs.paxos.com/crypto-brokerage/ledger-type#fiat-and-crypto-subledger) initiating transfers on behalf of their end users.
  - `metadata` object — Optional client-specified metadata. Up to 6 key/value pairs may be provided. Each key and value must be less than or equal to 100 characters.
  - `memo` string — Optional additional memo to be set on the outgoing withdrawal. For wire withdrawals the character limit is 100. For CUBIX intrabank withdrawals, the character limit is 40. For DBS intrabank withdrawals, the character limit is 100. For SCB intrabank withdrawals, the character limit is 140.
  - `total` string, decimal — Total to withdraw, including fees. Specify exactly one of `amount` or `total`. When `total` is specified, Paxos initiates the withdrawal for `total` minus the fee.

## Response `200`

A successful response.

- Transfer
  - `id` string, required — The Paxos transfer ID.
  - `customer_id` string, required — The Paxos customer ID.
  - `profile_id` string, required — The target Profile of the transfer. The profile asset balance is debited or credited by the transfer.
  - `identity_id` string — The Paxos ID of the Identity associated with the transfer.
  - `ref_id` string — The optional client-specified ID for replay protection and lookup.
  - `amount` string, required — The amount sent in the transfer.
  - `total` string, required — The balance change from this transfer: amount - fee for deposits, and amount + fee for withdrawals. Unsigned.
  - `fee` string, required — The fee paid for the transfer.
  - `asset` string, required — The asset for this transfer. This profile's balance of this asset will be debited or credited.
  - `balance_asset` string — The balance_asset represents what asset's balance was affected at Paxos with this transfer. It only differs from Asset when the transfer includes conversion.
  - `direction` 'CREDIT' | 'DEBIT', required — Direction of the transfer.
  - `type` 'INTERNAL_TRANSFER_DEBIT' | 'INTERNAL_TRANSFER_CREDIT' | 'CRYPTO_DEPOSIT' | 'CRYPTO_WITHDRAWAL' | 'WIRE_DEPOSIT' | 'WIRE_WITHDRAWAL' | 'SEN_DEPOSIT' | 'SEN_WITHDRAWAL' | 'BANK_DEPOSIT' | 'BANK_WITHDRAWAL' | 'PAXOS_TRANSFER_DEBIT' | 'PAXOS_TRANSFER_CREDIT' | 'SIGNET_DEPOSIT' | 'SIGNET_WITHDRAWAL' | 'CBIT_WITHDRAWAL' | 'CBIT_DEPOSIT' | 'CUBIX_DEPOSIT' | 'CUBIX_WITHDRAWAL' | 'RTP_DEPOSIT', required — Type of transfer.
  - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required
  - `secondary_status` SecondaryStatus — Secondary status for the transfer, used for more granular explanation of the transfer status.
    - `name` 'TRAVEL_RULE_INFO_REQUESTED' | 'TRAVEL_RULE_REJECTED' | 'CUSTOMER_REJECTED' | 'PENDING_CUSTOMER_APPROVAL' — Identifier for secondary status. - TRAVEL_RULE_INFO_REQUESTED: Travel rule information is required to continue processing the transfer. - TRAVEL_RULE_REJECTED: Transfer has been terminally rejected due to failing travel rule checks. - CUSTOMER_REJECTED: Transfer was rejected by a customer. - PENDING_CUSTOMER_APPROVAL: Transfer is pending customer approval.
    - `detail` string — Additional information about the current status of the transfer (e.g. if information is missing).
  - `status_details` TransferStatusDetails — TransferStatusDetails provides additional information about why a transfer is in its current state. This field is only populated when a transfer encounters specific error conditions or requires additional context.
    - `missing_trustline` MissingTrustline — MissingTrustline represents a failed transfer where the destination account lacks the required asset trustline.
      - `message` string
      - `destination_address` string
      - `asset` string
    - `max_rent_exceeded` MaxRentExceeded — MaxRentExceeded represents a failed transfer that was flagged for system abuse. When a withdrawal's rent calculation for the destination account exceeds the maximum allowed rent threshold, it may indicate malicious behavior. This status detail is set when such transfers are automatically cancelled.
      - `message` string
      - `destination_address` string
    - `pending_customer_approval` PendingCustomerApproval — PendingCustomerApproval represents that this resource is awaiting customer approval.
      - `message` string
      - `awaiting_action_from` 'AWAITING_ACTION_FROM_UNSPECIFIED' | 'AWAITING_ACTION_FROM_CLIENT' | 'AWAITING_ACTION_FROM_PAXOS' — AwaitingActionFrom indicates who needs to act on or is responsible for a given status. - AWAITING_ACTION_FROM_CLIENT: The customer needs to take action. - AWAITING_ACTION_FROM_PAXOS: Paxos needs to take action.
    - `stale_fee_quote` StaleFeeQuote — StaleFeeQuote represents a transfer cancelled because on-chain state changed after the fee was quoted.
      - `message` string
    - `invalid_destination_address` InvalidDestinationAddress — InvalidDestinationAddress represents a transfer cancelled because the destination address cannot receive the requested asset (e.g. it is a token account for a different mint).
      - `message` string
      - `destination_address` string
  - `created_at` string, date-time, required — The time at which this transfer record was created.
  - `updated_at` string, date-time, required — The time at which this transfer record was most recently updated.
  - `metadata` object — Optional client-specified stored metadata. For deposit event transfers this metadata is copied from the crypto deposit address or fiat deposit memo used for attribution. Up to 6 key/value pairs may be returned. Each key and value must be less than or equal to 100 characters.
  - `destination_address` string — The destination crypto address.
  - `crypto_network` 'BITCOIN' | 'ETHEREUM' | 'BITCOIN_CASH' | 'LITECOIN' | 'SOLANA' | 'POLYGON_POS' | 'BASE' | 'ARBITRUM_ONE' | 'STELLAR' | 'INK' | 'XLAYER' | 'AVALANCHE' | 'DOGECOIN' | 'SUI' | 'ROBINHOOD' | 'BNB' — A CryptoNetwork is a blockchain transmitting cryptocurrencies.
  - `crypto_tx_hash` string — For crypto transactions, the on-chain transaction hash.
  - `crypto_tx_index` string — For crypto transactions, the output index or output address.
  - `account_id` string — The Paxos ID of the Account associated with the transfer.
  - `auto_conversion` AutoConversion
    - `from_transfer_id` string
    - `to_transfer_id` string
  - `group_id` string — Unique identifier linking the debit and credit sides of an internal or Paxos transfer.
  - `fiat_account_id` string — For fiat withdrawals, the Paxos ID of the owner's fiat account (UUID).
  - `notional_value` string, decimal — For crypto withdrawals and deposits, the USD value of the combined amount and fee at the time of the transfer.
  - `memo` string — An optional memo to be included with the transfer as an identifier.

## Other responses

- `400` — Bad Request
- `403` — Insufficient funds
- `404` — Could not find Profile
- `409` — Transfer already exists

---

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