List Virtual Accounts

List all virtual accounts for your business.

Returns all virtual accounts created under your business.

Endpoint

GET /v1/virtual-accounts

Authentication

Header	Value
x-api-key	Your API key

Example request

cURL

curl -X GET https://ramp-api.ivorypay.io/api/v1/virtual-accounts \
  -H "x-api-key: your_api_key"

Node.js

Python

Go

Example response

{
  "statusCode": 200,
  "success": true,
  "message": "Query successful",
  "data": [
    {
      "id": "va-uuid-1",
      "bankName": "Providus Bank",
      "virtualAccountNumber": "9900123456",
      "virtualAccountName": "IvoryPay - User One",
      "currency": "NGN",
      "status": "Enabled",
      "createdAt": "2026-03-26T12:00:00.000Z"
    },
    {
      "id": "va-uuid-2",
      "bankName": "Providus Bank",
      "virtualAccountNumber": "9900654321",
      "virtualAccountName": "IvoryPay - User Two",
      "currency": "NGN",
      "status": "Enabled",
      "createdAt": "2026-03-25T10:00:00.000Z"
    }
  ]
}