Utilities

Get whitelisted addresses

List your organization's whitelisted wallet addresses.

GET
/api/v2/whitelisted-addresses

Returns all whitelisted addresses for the authenticated organization, including entries pending approval.

Authorization

bearerAuth
AuthorizationBearer <token>

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"
}