Virtual accounts

Fetch a virtual account

GET/api/v1/virtual-accounts/{virtualAccountID}

AuthorizationBearer sk_test_… or sk_live_…

Path parameters#

virtualAccountIDuuidRequired

Responses#

200The virtual account
401The secret key is missing, invalid or revoked.
403The key is not allowed to do this, or the request came from an address that is not on its allowlist.
404Nothing was found for this business and mode.

curl "https://api.vervapay.com/api/v1/virtual-accounts/6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11" \
  -H "Authorization: Bearer $FASTPAY_SECRET_KEY"

200The virtual account

{
  "data": {
    "created_at": "2026-10-28T09:00:00Z",
    "currency": "NGN",
    "id": "6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11",
    "provider": "palmpay",
    "status": "active",
    "type": "static",
    "account_name": "Ada Obi",
    "account_number": "9012345678",
    "bank_name": "PalmPay",
    "customer_ref": "cust_1001"
  }
}