List customer virtual accounts
List all virtual bank accounts for a customer.
Returns all virtual bank accounts (IBANs) for the customer, including their status and details.
Authorization
bearerAuth Organization API key obtained on Settings > API Keys page in Compose UI.
In: header
Path Parameters
Unique identifier of the customer
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET 'https://compose.finance/api/v2/customers/{customerId}/virtual-accounts' \ -H 'Authorization: Bearer YOUR_API_KEY'[
{
"virtualAccountId": "corr-12345-abcde",
"status": "APPROVED",
"currency": "EUR",
"virtualAccount": {
"iban": "DK0012345678123456",
"bic": "EXAMPLEBICXXX",
"accountName": "JOHN DOE",
"accountNumber": "1234567890",
"addressDetails": {
"addressLine1": "123 Example Street",
"city": "London",
"postcode": "SW1A 1AA",
"country": "GB",
"nationality": "GB",
"dateOfBirth": "1990-01-15"
},
"bankName": "Example Bank",
"bankCountry": "Denmark",
"bankAddress": "1 Example Plaza, Copenhagen, Denmark"
},
"message": "Virtual account is active",
"createdAt": "2026-01-15T10:30:00.000Z"
},
{
"virtualAccountId": "corr-67890-fghij",
"status": "PENDING",
"currency": "USD",
"message": "Virtual account creation is pending",
"createdAt": "2026-01-20T14:00:00.000Z"
}
]{
"error": "Unauthorized - Invalid or missing API key or session"
}{
"error": "Virtual accounts feature is not enabled for your organization"
}{
"error": "Customer not found"
}{
"error": "Rate limit exceeded. Please try again later."
}{
"error": "Internal server error"
}Get customer virtual account GET
Returns the virtual account details and status for a specific virtual account ID. Use `GET /virtual-accounts` to list all virtual accounts for a customer.
Counterparty Information Required Webhook
Triggered when an incoming or outgoing transfer needs information about the other wallet's owner, and again when Compose asks for more. Deduplicate by eventId and load the request for its latest status. Identity details are not included in this event.

