> 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/integration-guides/fiat-bridge/endpoints-and-methods.md).

# Endpoints and Methods

### Retail Customer Onboarding

<table><thead><tr><th width="288" valign="top">Endpoint</th><th width="100" valign="top">Method</th><th valign="top">Purpose</th></tr></thead><tbody><tr><td valign="top"><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers#post-v1-customers">/v1/customers</a></td><td valign="top"><code>POST</code></td><td valign="top">Submit a new customer for onboarding. Returns customerId, initial statuses, and required documents list.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers/docs#post-v1-customers-customerid-docs">/v1/customers/{customerId}/docs</a></td><td valign="top"><code>POST</code></td><td valign="top">Submit identity documentation for a customer awaiting onboarding.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers/docs#put-v1-customers-customerid-docs">/v1/customers/{customerId}/docs</a></td><td valign="top"><code>PUT</code></td><td valign="top">Resubmit a previously rejected document.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers/docs#get-v1-customers-customerid-docs-documentid">/v1/customers/{customerId}/docs/{documentId}</a></td><td valign="top"><code>GET</code></td><td valign="top">Retrieve a previously submitted document.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers#get-v1-customers">/v1/customers</a></td><td valign="top"><code>GET</code></td><td valign="top">List customers and their current customerStatus / onboardingStatus.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers#get-v1-customers-customerid">/v1/customers/{customerId}</a></td><td valign="top"><code>GET</code></td><td valign="top">Retrieve a single customer record by ID.</td></tr></tbody></table>

### Business Customer Onboarding

<mark style="color:red;">>>coming soon<<</mark>

### Add Customer Crypto Addresses

<table><thead><tr><th width="298">Endpoint</th><th width="100">Method</th><th width="348">Purpose</th></tr></thead><tbody><tr><td>​<a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers/crypto-addresses#post-v1-customers-customerid-crypto-addresses">/v1/customers/{customerId}/crypto-addresses</a></td><td><code>POST</code></td><td>Add a new crypto address for a customer</td></tr><tr><td>​<a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers/crypto-addresses#get-v1-customers-customerid-crypto-addresses">/v1/customers/{customerId}/crypto-addresses</a></td><td><code>GET</code></td><td>List all crypto addresses for a customer</td></tr><tr><td>​<a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers/crypto-addresses#get-v1-customers-customerid-crypto-addresses-cryptoaddressid">/v1/customers/{customerId}/crypto-addresses/{cryptoAddressId}</a></td><td><code>GET</code></td><td>Retrieve a specific crypto address</td></tr><tr><td>​<a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers/crypto-addresses#delete-v1-customers-customerid-crypto-addresses-cryptoaddressid">/v1/customers/{customerId}/crypto-addresses/{cryptoAddressId}</a></td><td><code>DELETE</code></td><td>Remove a specific crypto address</td></tr></tbody></table>

### Funding Requests

<table><thead><tr><th width="288.1241455078125" valign="top">Endpoint</th><th width="99.69921875" valign="top">Method</th><th width="360.1766357421875" valign="top">Purpose</th></tr></thead><tbody><tr><td valign="top"><a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/funding-requests#get-v1-funding-request">v1/funding-request</a></td><td valign="top"><code>GET</code></td><td valign="top">List all funding requests. Supports cursor-based pagination and filtering by status, currency, network, and date range.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/funding-requests#get-v1-funding-request-fundingrequestid">/v1/funding-request/{fundingRequestId}</a></td><td valign="top"><code>GET</code></td><td valign="top">Retrieve a single funding request by ID. Returns the complete record including deposit address, status, conversion rate, and any associated deposit IDs.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/funding-requests#post-v1-funding-request">/v1/funding-request</a></td><td valign="top"><code>POST</code></td><td valign="top">Create a new funding request. Returns deposit instructions (wallet address, network, currency), conversion rate, status, and lifecycle timestamps.</td></tr><tr><td valign="top"><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/funding-requests#delete-v1-funding-request-fundingrequestid">/v1/funding-request/{fundingRequestId}</a></td><td valign="top"><code>DELETE</code></td><td valign="top">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.</td></tr></tbody></table>

{% hint style="info" %}
Full request and response schemas, including optional parameters, are available in the [Funding Requests ](/cams/api-reference/funding-requests.md)section of the Aquanow CAMS API Reference on GitBook.
{% endhint %}

### ​Payouts

<table><thead><tr><th width="200.375">Endpoint</th><th width="99.640625">Method</th><th>Purpose</th></tr></thead><tbody><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/payouts#get-v1-payouts">/v1/payouts</a></td><td><code>GET</code></td><td>List all payouts. Supports cursor-based pagination and filtering by payout ID, beneficiary ID, source currency, beneficiary currency, status, and request date.</td></tr><tr><td><a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/payouts#get-v1-payouts-payoutid">/v1/payouts/{payoutId}</a></td><td><code>GET</code></td><td>Retrieve a single payout by ID. Returns complete payout details including beneficiary information, payout amounts, fees, conversion rate, status, and lifecycle timestamps.</td></tr><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/payouts#post-v1-payouts">/v1/payouts</a></td><td><code>POST</code></td><td>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 <code>PENDING_AUTHORIZATION</code> state.</td></tr><tr><td><a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/payouts#patch-v1-payouts-authorize">/v1/payouts/authorize</a></td><td><code>PATCH</code></td><td>Authorize a previously created payout for processing. Requires sufficient account buying power. Returns the updated payout record with authorization and processing status information.</td></tr></tbody></table>

### Merchant Settlements

<table><thead><tr><th width="243">Endpoint</th><th width="100">Method</th><th width="399">Purpose</th></tr></thead><tbody><tr><td><a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers#post-v1-customers-customerid-bankinfo">/v1/customers/{customerId}/bankinfo</a></td><td><code>POST</code></td><td>Register external bank account details. These will be used in withdrawal instructions to send fiat to a customer's banking institution.</td></tr><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers#get-v1-customers-customerid-bankinfo">/v1/customers/{customerId}/bankinfo</a></td><td><code>GET</code></td><td>List registered bank accounts for a customer</td></tr><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers#get-v1-customers-customerid-bankinfo-bankaccountid">/v1/customers/{customerId}/bankinfo/bankAccountId</a></td><td><code>GET</code></td><td>Retrieve specific registered bank account details.</td></tr><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/customers#delete-v1-customers-customerid-bankinfo-bankaccountid">/v1/customers/{customerId}/bankinfo/{bankAccountId}</a></td><td><code>DELETE</code></td><td>Remove specific registered bank account details.</td></tr><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/withdrawals#post-v1-withdrawals">/v1/withdrawals</a></td><td><code>POST</code></td><td>Initiate a fiat withdrawal from a platform account to a registered bank account.</td></tr><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/transactions#get-v1-transactions">/v1/transactions</a></td><td><code>GET</code></td><td>List transactions.</td></tr><tr><td><a href="https://app.gitbook.com//s/4LnbO9QFRq3XZT6kRr2v/api-reference/transactions#get-v1-transactions-transactionid">/v1/transactions/
{transactionId}</a></td><td><code>GET</code></td><td>Retrieve a specific transaction</td></tr><tr><td><a href="https://app.gitbook.com/s/4LnbO9QFRq3XZT6kRr2v/api-reference/accounts/configuration#get-v1-accounts-accountid-configuration">/v1/accounts/{accountId}/configuration</a></td><td><code>GET</code></td><td>Retrieve fiat deposit instructions to send fiat to a customer's account on the Aquanow platform.</td></tr></tbody></table>

{% hint style="info" %}
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.<br>
{% endhint %}