> For the complete documentation index, see [llms.txt](https://docs.aquanow.io/cams/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aquanow.io/cams/api-reference/withdrawals.md).

# Withdrawals

## Request withdrawal.

> Initiate a withdrawal.

```json
{"openapi":"3.0.3","info":{"title":"Aquanow CAMS REST API","version":"1.0"},"servers":[{"url":"https://cams.aquanow.com/api","description":"production"},{"url":"http://localhost:3001/api","description":"local"},{"url":"https://cams.dev.aquanow.com/api","description":"dev"},{"url":"https://cams.staging.aquanow.com/api","description":"staging"},{"url":"https://cams.cert.aquanow.com/api","description":"cert"},{"url":"https://marketdata.aquanow.com","description":"production market data"},{"url":"https://marketdata.staging.aquanow.com","description":"staging market data"},{"url":"https://marketdata.dev.aquanow.com","description":"dev market data"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}},"parameters":{"X-Request-Id-Withdrawal":{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string"},"description":"A unique 'Reference Number' for each incoming withdrawal request. Any retries will retain the same x-request-Id value."}},"schemas":{"ID":{"type":"string","format":"uuid"},"StoredBankAccountInformation":{"type":"object","required":["bankAccountId","bankAccountInformation","status"],"properties":{"bankAccountId":{"type":"string","format":"uuid"},"bankAccountInformation":{"$ref":"#/components/schemas/ClientBankingInstruction"},"status":{"$ref":"#/components/schemas/BankAccountInformationStatus"},"createdAt":{"type":"string","format":"date-time"},"statusReason":{"type":"string","nullable":true}}},"ClientBankingInstruction":{"type":"object","required":["beneficiaryType","currency","beneficiaryAddress","beneficiaryBankName","beneficiaryBankAddress","beneficiaryAccountNumber"],"properties":{"beneficiaryType":{"$ref":"#/components/schemas/ClientBeneficiaryType"},"currency":{"type":"string","description":"ISO 3-letter currency code"},"beneficiaryAddress":{"$ref":"#/components/schemas/AddressInput"},"beneficiaryBankName":{"type":"string","maxLength":255,"description":"The name of the financial institution holding the beneficiary account."},"beneficiaryBankAddress":{"$ref":"#/components/schemas/AddressInput"},"beneficiaryBankBic":{"type":"string","minLength":8,"maxLength":11,"description":"The unique identifier code for the beneficiary institution, such as a BIC (Bank Identifier Code) or SWIFT code. Typically 8-11 characters.","nullable":true},"routingCode":{"type":"string","maxLength":20,"description":"The clearing code or routing number for the beneficiary institution. Used for domestic transfers.","nullable":true},"beneficiaryAccountNumber":{"type":"string","maxLength":34,"description":"The account number or IBAN of the beneficiary. Supports various formats (e.g., IBAN up to 34 characters)."},"beneficiaryBankMemo":{"type":"string","maxLength":140,"description":"Payment reference sent with the transfer. If provided, ensures the funds are processed without unnecessary delays and helps the beneficiary identify the payment purpose.","nullable":true},"intermediaryBankName":{"type":"string","nullable":true,"description":"The name of the intermediary financial institution facilitating the payment (e.g., for cross-border transfers). Required only if an intermediary is involved."},"intermediaryBankAddress":{"$ref":"#/components/schemas/AddressInput","nullable":true},"intermediaryBankBic":{"type":"string","minLength":8,"maxLength":11,"nullable":true,"description":"BIC/SWIFT code of the intermediary bank. If required for the payment route, ensures proper routing and prevents delays or rejections."},"intermediaryAccountNumber":{"type":"string","maxLength":34,"nullable":true,"description":"Account number held at the intermediary bank for correspondent banking. If required, ensures funds are properly credited and forwarded without delays."},"beneficiaryGivenNames":{"type":"string","maxLength":200,"description":"Required for INDIVIDUAL beneficiary type"},"beneficiarySurnames":{"type":"string","maxLength":200,"description":"Required for INDIVIDUAL beneficiary type"},"beneficiaryLegalName":{"type":"string","maxLength":255,"description":"Required for BUSINESS beneficiary type","nullable":true}}},"ClientBeneficiaryType":{"type":"string","enum":["INDIVIDUAL","BUSINESS"]},"AddressInput":{"type":"object","required":["addressLine1","city","region","country"],"properties":{"addressLine1":{"type":"string","description":"Street address"},"addressLine2":{"type":"string","description":"Apartment, suite, unit, building, floor, etc.","nullable":true},"city":{"type":"string","description":"City, town or village"},"region":{"type":"string","description":"State or province"},"postalCode":{"type":"string","description":"ZIP or postal code","nullable":true},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code"}}},"BankAccountInformationStatus":{"type":"string","enum":["PENDING","ACTIVE","FAILED","REMOVED","COOLING_OFF","COOLED_OFF"]},"Withdrawal":{"type":"object","required":["withdrawalId","customerId","accountId","withdrawalCurrency","status","netWithdrawalQuantity","withdrawalFeeType","withdrawalFeeRate","withdrawalFeeQuantity","withdrawalFeeCurrency","grossWithdrawalQuantity","requestedAt","transactionType"],"properties":{"transactionType":{"$ref":"#/components/schemas/TransactionType"},"transactionStatus":{"$ref":"#/components/schemas/TransactionStatus"},"withdrawalId":{"$ref":"#/components/schemas/ID"},"customerId":{"$ref":"#/components/schemas/ID"},"accountId":{"$ref":"#/components/schemas/ID"},"withdrawalCurrency":{"type":"string"},"netWithdrawalQuantity":{"$ref":"#/components/schemas/Financial"},"withdrawalFeeType":{"$ref":"#/components/schemas/WithdrawalFeeType"},"withdrawalFeeRate":{"$ref":"#/components/schemas/Financial"},"withdrawalFeeQuantity":{"$ref":"#/components/schemas/Financial"},"withdrawalFeeCurrency":{"type":"string"},"memo":{"type":"string","nullable":true},"txHash":{"type":"string","nullable":true},"clientMemo":{"type":"string","nullable":true},"grossWithdrawalQuantity":{"$ref":"#/components/schemas/Financial"},"requestedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true}}},"TransactionType":{"type":"string","enum":["DEPOSIT","WITHDRAWAL","TRANSFER"]},"TransactionStatus":{"type":"string","enum":["FAILED","PROCESSING","CONFIRMING","COMPLETED"]},"Financial":{"type":"string"},"WithdrawalFeeType":{"type":"string","enum":["FIXED","VARIABLE","LIVE"]}},"headers":{"X-Request-Id":{"description":"Unique identifier for this request. If the client supplied X-Request-Id, the same value is returned.","schema":{"type":"string"}}},"responses":{"400":{"description":"Validation Error"},"401":{"description":"Unauthorized"},"403":{"description":"Insufficient Privileges"},"409":{"description":"Duplicate request error","content":{"application/json":{"schema":{"properties":{"id":{"type":"string"}}}}}},"4XX":{"description":"Client error"},"5XX":{"description":"Server error"}}},"paths":{"/v1/withdrawals":{"post":{"summary":"Request withdrawal.","description":"Initiate a withdrawal.","tags":["Transactions"],"operationId":"RequestWithdrawal","parameters":[{"$ref":"#/components/parameters/X-Request-Id-Withdrawal"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["accountId","currency","quantity"],"properties":{"accountId":{"$ref":"#/components/schemas/ID"},"currency":{"type":"string"},"quantity":{"type":"string","description":"The quantity to withdraw"},"bankAccount":{"$ref":"#/components/schemas/StoredBankAccountInformation"},"clientMemo":{"type":"string","description":"Optional memo or note for the withdrawal","nullable":true}}}}}},"responses":{"200":{"description":"Successful response","headers":{"X-Request-Id":{"$ref":"#/components/headers/X-Request-Id"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Withdrawal"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"409":{"$ref":"#/components/responses/409"},"4XX":{"$ref":"#/components/responses/4XX"},"5XX":{"$ref":"#/components/responses/5XX"}}}}}}
```