Endpoints and Methods

Retail Customer Onboarding

Endpoint	Method	Purpose
/v1/customers	POST	Submit a new customer for onboarding. Returns customerId, initial statuses, and required documents list.
/v1/customers/{customerId}/docs	POST	Submit identity documentation for a customer awaiting onboarding.
/v1/customers/{customerId}/docs	PUT	Resubmit a previously rejected document.
/v1/customers/{customerId}/docs/{documentId}	GET	Retrieve a previously submitted document.
/v1/customers	GET	List customers and their current customerStatus / onboardingStatus.
/v1/customers/{customerId}	GET	Retrieve a single customer record by ID.

Business Customer Onboarding

>>coming soon<<

Add Customer Crypto Addresses

Endpoint	Method	Purpose
​/v1/customers/{customerId}/crypto-addresses	POST	Add a new crypto address for a customer
​/v1/customers/{customerId}/crypto-addresses	GET	List all crypto addresses for a customer
​/v1/customers/{customerId}/crypto-addresses/{cryptoAddressId}	GET	Retrieve a specific crypto address
​/v1/customers/{customerId}/crypto-addresses/{cryptoAddressId}	DELETE	Remove a specific crypto address

Funding Requests

Endpoint	Method	Purpose
v1/funding-request	GET	List all funding requests. Supports cursor-based pagination and filtering by status, currency, network, and date range.
/v1/funding-request/{fundingRequestId}	GET	Retrieve a single funding request by ID. Returns the complete record including deposit address, status, conversion rate, and any associated deposit IDs.
/v1/funding-request	POST	Create a new funding request. Returns deposit instructions (wallet address, network, currency), conversion rate, status, and lifecycle timestamps.
/v1/funding-request/{fundingRequestId}	DELETE	Retire an active funding request. Marks the record as REMOVED so the deposit address is no longer accepted. Resolve any in-flight deposits before calling this endpoint.

Full request and response schemas, including optional parameters, are available in the Funding Requests section of the Aquanow CAMS API Reference on GitBook.

​Payouts

Endpoint	Method	Purpose
/v1/payouts	GET	List all payouts. Supports cursor-based pagination and filtering by payout ID, beneficiary ID, source currency, beneficiary currency, status, and request date.
/v1/payouts/{payoutId}	GET	Retrieve a single payout by ID. Returns complete payout details including beneficiary information, payout amounts, fees, conversion rate, status, and lifecycle timestamps.
/v1/payouts	POST	Create a new payout request. Returns payout details including beneficiary information, payout amount, fees, conversion rate, status, and lifecycle timestamps. Newly created payouts are returned in a PENDING_AUTHORIZATION state.
/v1/payouts/authorize	PATCH	Authorize a previously created payout for processing. Requires sufficient account buying power. Returns the updated payout record with authorization and processing status information.

Merchant Settlements

Endpoint	Method	Purpose
/v1/customers/{customerId}/bankinfo	POST	Register external bank account details. These will be used in withdrawal instructions to send fiat to a customer's banking institution.
/v1/customers/{customerId}/bankinfo	GET	List registered bank accounts for a customer
/v1/customers/{customerId}/bankinfo/bankAccountId	GET	Retrieve specific registered bank account details.
/v1/customers/{customerId}/bankinfo/{bankAccountId}	DELETE	Remove specific registered bank account details.
/v1/withdrawals	POST	Initiate a fiat withdrawal from a platform account to a registered bank account.
/v1/transactions	GET	List transactions.
/v1/transactions/ {transactionId}	GET	Retrieve a specific transaction
/v1/accounts/{accountId}/configuration	GET	Retrieve fiat deposit instructions to send fiat to a customer's account on the Aquanow platform.

The Transactions API provides a comprehensive audit trail of all digital and fiat asset movements through your Aquanow accounts. This permanent ledger captures deposits, withdrawals, transfers, and internal adjustments with cryptographic proof of completion.