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