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. Omit to list all.

Required string length: 1 - 100
Example:

"user-12345"

Response

Customer virtual accounts retrieved successfully

status
integer
required
Example:

200

message
string
required
Example:

"Customer virtual accounts retrieved successfully"

success
boolean
required
Example:

true

data
object
required