Skip to main content
GET
List Customer Virtual Accounts
List the permanent per-end-user virtual accounts you’ve created for your business. Optionally filter to a single user with customer_identifier.

Example Request

Query Parameters

Example Response

This endpoint returns end-user PII. The raw BVN is never included — only bvn_last4. If your API key has an IP allowlist configured, it applies here as it does to every endpoint.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Query Parameters

customer_identifier
string

Filter to a single end-user's account.

Response

Customer virtual accounts retrieved successfully

success
boolean
Example:

true

message
string
Example:

"Customer virtual accounts retrieved successfully"

data
object