--- title: "GET /v1/customers/{customer_id}/withdrawals" method: GET path: "/v1/customers/{customer_id}/withdrawals" tags: ["crate::connectivity::controller::openapi::withdrawals"] --- # GET /v1/customers/{customer_id}/withdrawals `GET /v1/customers/{customer_id}/withdrawals` ## Request - Base URL: `https://api.1money.com` - URL: `https://api.1money.com/v1/customers/{customer_id}/withdrawals` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `customer_id` string, required ## Query parameters - `idempotency_key` string, required: HTTP `Idempotency-Key` header value. Stricter than other IDs: ≤64 ASCII chars per the common REST API convention. ## Response `200` - WithdrawalResponse - `wallet_address` string, nullable: Wallet address for a crypto transaction. For withdrawal requests, this is the external destination wallet and cannot be provided together with `external_account_id`. Transaction responses expose the actual on-chain origin in `source.wallet_address` and the receiving wallet in `destination.wallet_address`. Examples - **Wallet Address** `0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d` - `external_account_id` string, nullable: External account ID for fiat withdrawals Required for fiat currency withdrawals (e.g., USD, MXN). Identifies the external bank account used for the transfer. Cannot be provided together with wallet_address. Examples - **External Account ID** `ffb9e832-8e64-11f0-b308-2eaa4f6974f2` - `amount` string, required: Amount to withdraw - `asset` string, required: - Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported) - Digital assets: BTC, ETH, SOL - Fiat currencies: USD, MXN - `network` string, required: Public network identifier for bank, blockchain and internal transactions. Allowed values: - Bank: `US_ACH`, `US_FEDWIRE`, `US_RTP`, `US_FEDNOW`, `SWIFT`, `CUBIX`, `SPEI`, `PIX_TRANSFER`, `LOCAL_BANK_TRANSFER`, `CHATS`, `FPS`, `SEPA`, `FASTER_PAYMENT`, `UAEFTS`, `UPI`, `EREBOR_RAIL` - Blockchain: `ETHEREUM`, `POLYGON`, `ARBITRUM`, `AVALANCHE`, `BASE`, `BNBCHAIN`, `SOLANA`, `TRON`, `ONE_MONEY`, `BITCOIN` - Internal: `INTERNAL` Availability depends on the asset and customer account configuration. - `purpose_code` string, nullable: Purpose code for a fiat withdrawal. Some fiat withdrawals require a purpose code. Select the complete canonical value from the [Local Payment Code](https://developer.1money.com/docs/local-payment-code) guide based on the destination country and network. Submit it exactly as documented, including the country and network prefix; do not add, remove, or modify the prefix. For example, a business-to-business USD `SWIFT` withdrawal to China requires a code such as `cn_swift_cgoddr`. - `memorandum` string, nullable: A string representing the message about the fiat transaction. Values longer than 256 characters are truncated. - `mode` 'prefunding' | 'null', nullable: Withdrawal mode. Set to `prefunding` to fund the withdrawal from the main account on behalf of the customer specified in `on_behalf_of`. - `on_behalf_of` string, nullable: The customer ID to execute the withdrawal on behalf of. Required when `mode` is `prefunding`. The customer must belong to the same entity as the API key owner. - `amount_type` 'SEND_AMOUNT' | 'RECEIVE_AMOUNT' | 'null', nullable: Controls how the fee is applied to the withdrawal amount. - `SEND_AMOUNT` (default): Fee is deducted from the amount. Amount = what leaves the sender. - `RECEIVE_AMOUNT`: Fee is added on top. Amount = what the recipient gets. - `transaction_id` string, required: Unique transaction identifier - `idempotency_key` string, required: HTTP `Idempotency-Key` header value. Stricter than other IDs: ≤64 ASCII chars per the common REST API convention. - `status` 'PENDING' | 'COMPLETED' | 'FAILED' | 'RETURNED' | 'MICRO_DEPOSIT_REVERSED', required - `action_required` ActionRequired - `type` string, required - `case_id` string, required: RFI case business ID. - `action` string, required - `transaction_fee` FeeMeta, required - `value` string, required: Fee amount - `asset` string, required: - Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported) - Digital assets: BTC, ETH, SOL - Fiat currencies: USD, MXN - `platform_fee` FeeMeta, required - `value` string, required: Fee amount - `asset` string, required: - Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported) - Digital assets: BTC, ETH, SOL - Fiat currencies: USD, MXN - `partner_fee` FeeMeta, required - `value` string, required: Fee amount - `asset` string, required: - Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported) - Digital assets: BTC, ETH, SOL - Fiat currencies: USD, MXN - `transaction_action` 'WITHDRAWAL', required - `created_at` string, required - `modified_at` string, required - `reference` string, nullable: Transaction reference: on-chain tx hash (crypto) or UETR (fiat) - `funder_pid` string: Portfolio ID — also exposed as `customer_id` in OpenAPI. Identifies one individual application / portfolio row within an entity. - `funder_account_id` string, nullable - `recipient_id` string, nullable: Recipient ID for third-party payouts. Present only when this withdrawal targets a recipient (cpid is non-empty); absent for self-withdrawals. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `405`: Method Not Allowed - `500`: Internal Server Error ## Changes - **2026-11-03** `d213edbaccb6`: 1 info - endpoint added [Operation history](https://skmtc.dev/1money/apis/1money-openapi/changes/v1/customers/:customer_id/withdrawals/get.md) --- [API](https://skmtc.dev/1money/apis/1money-openapi.md) - [All operations](https://skmtc.dev/1money/apis/1money-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/1money/apis/1money-openapi/revisions/d213edbaccb6?raw)