Get whitelisted addresses
List your organization's whitelisted wallet addresses.
Returns all whitelisted addresses for the authenticated organization, including entries pending approval.
Authorization
bearerAuth Organization API key obtained on Settings > API Keys page in Compose UI.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET 'https://compose.finance/api/v2/whitelisted-addresses' \ -H 'Authorization: Bearer YOUR_API_KEY'{
"addresses": [
{
"id": "wa_abc123",
"network": "base",
"address": "0x1234567890abcdef1234567890abcdef12345678",
"name": "Treasury Wallet",
"status": "ACTIVE",
"proposedTransactionId": null,
"pendingChange": null,
"createdAt": "2026-05-01T10:15:00.000Z",
"updatedAt": "2026-05-01T10:15:00.000Z"
},
{
"id": "wa_def456",
"network": "base",
"address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
"name": "Vendor Wallet",
"status": "PROPOSED",
"proposedTransactionId": "txn_123456789",
"pendingChange": "ADD",
"createdAt": "2026-05-02T11:00:00.000Z",
"updatedAt": "2026-05-02T11:00:00.000Z"
}
]
}{
"error": "Unauthorized - Invalid or missing API key or session"
}{
"error": "Customers feature is not enabled for your organization"
}{
"error": "Rate limit exceeded. Please try again later."
}{
"error": "Internal server error"
}Get customer transactions GET
Returns the transaction history for a specific customer. Only includes DEPOSIT and WITHDRAWAL transactions. For deposit transactions where `developerFee` is present, wallet receive amount = `targetAmount - developerFee.amount`. For AUD-only customers, each AUD payment is a `DEPOSIT` with `paymentRail: "AU_BANK_TRANSFER"`, `sourceCurrency: "AUD"` and `payerName`; payments on hold are reported as `PROCESSING`. A returned AUD payment reports `PENDING_REVERSAL` while the return is in flight and `REVERSED` once it settles. An AUD withdrawal the recipient's bank returns, before or after `COMPLETED`, reports `PENDING_REVERSAL` while it is refunded, then `REVERSED`, refunded less the reversal fee (see `reversal`).
Whitelist addresses POST
Creates a whitelisted address proposal in PROPOSED status. Wallet approvers must approve it in the dashboard before it becomes active.

