# 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},"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","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"}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aquanow.io/cams/api-reference/withdrawals.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.