Use this endpoint to check if a virtual account has received a successful credit within a recent time window.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/wallets/verify?accountNumber=1234567890&amount=5000&sinceMinutes=60

Query Parameters

Field	Data Type	Required	Description
accountNumber	string	Yes, if `accountId` is not supplied	Virtual account number to verify.
accountId	string	Yes, if `accountNumber` is not supplied	Virtual account ID to verify.
amount	string	No	Expected amount. Must be positive when supplied.
reference	string	No	Transaction reference to match.
sinceMinutes	string	No	Lookback window in minutes. Defaults to `60`; minimum `1`, maximum `1440`.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "status": "SUCCESS",
    "accountNumber": "1234567890",
    "accountId": "89d8f903-96f6-48df-af97-1f2b3bb64260",
    "amount": 5000,
    "mode": "live",
    "matched": true,
    "transaction": {
      "id": "f6cbda33-1a40-4f2e-a211-fd87bd86cc4a",
      "reference": "KYSHI-1778623597453",
      "amount": 5000,
      "netAmount": 4990,
      "currency": "NGN",
      "status": "SUCCESS",
      "webhookStatus": "DELIVERED",
      "createdAt": "2026-05-20T10:20:00.000Z",
      "updatedAt": "2026-05-20T10:20:00.000Z"
    }
  }
}