Customers

List customers

List and manage all customers in your organization.

GET
/api/v2/customers

Returns all customers for the authenticated organization. Requires Bearer token authentication.

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

curl -X GET 'https://compose.finance/api/v2/customers' \  -H 'Authorization: Bearer YOUR_API_KEY'
[
  {
    "customerId": "550e8400-e29b-41d4-a716-446655440001",
    "email": "[email protected]",
    "name": "JOHN DOE",
    "accountType": "individual",
    "expectedMonthlyVolume": 25000
  },
  {
    "customerId": "550e8400-e29b-41d4-a716-446655440002",
    "email": "[email protected]",
    "name": "ACME CORP LTD",
    "accountType": "corporate",
    "expectedMonthlyVolume": 75000
  },
  {
    "customerId": "550e8400-e29b-41d4-a716-446655440003",
    "email": "[email protected]",
    "name": "BOB WILSON",
    "accountType": "individual",
    "expectedMonthlyVolume": 10000
  }
]
{
  "error": "Unauthorized - Invalid or missing API key or session"
}
{
  "error": "Customers feature is not enabled for your organization"
}
{
  "error": "Internal server error"
}

Get customer GET

Returns details for a specific customer including KYC status. Requires Bearer token authentication.

Create customer wallet POST

Creates a crypto wallet address for the customer to receive USDC during deposits. **Wallet Requirements** - Must be a valid Ethereum address - Must support USDC on Base network - Wallet address must be unique within your organization **Licensing** - **Licensed organizations**: Wallet is optional. If no wallet is configured, funds will be forwarded to your organization's wallet. - **Unlicensed organizations**: A wallet must be configured for each customer before deposits can be processed.