Skip to main content
GET
/
business
/
virtualaccount
/
reference
Look up a virtual account by reference
curl --request GET \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/virtualaccount/reference \
  --header 'X-Numero-Api-Key: <api-key>'
{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "reference": "VA-20240115-abc123",
    "accountName": "John Doe",
    "accountNumber": "8012345678",
    "bankName": "Providus Bank",
    "providerCode": "PROVIDUS",
    "details": {
      "businessName": null,
      "category": "Individual",
      "email": "[email protected]",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "08012345678",
      "rcNumber": null,
      "tin": null,
      "type": "Customer"
    }
  },
  "error": null
}

Authorizations

X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Query Parameters

reference
string
required

Response

Successful response

Canonical response envelope for the public surface. data on success, error on failure.

data
any
required

Endpoint payload on success (object or array); null on failure.

error
object
required
meta
object
required