Customer Virtual Accounts, Transactions & KYC - Numero

Once a customer exists, these three read endpoints roll up everything attached to it — the virtual accounts you’ve issued them, the transactions that flowed through those accounts, and their KYC status. All are API-key only (no signature).

List a customer’s virtual accounts

GET /api/v1/business/customers/{id}/virtual-accounts

Query param	Type	Default	Description
`page`	integer	1	Page number
`pageSize`	integer	25	Rows per page

curl "https://api.usenumero.com/numeroaccount/api/v1/business/customers/4021/virtual-accounts" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2"

{
  "data": [
    {
      "id": 88,
      "reference": "VA-2024-abc",
      "accountName": "John Doe",
      "accountNumber": "8012345678",
      "bankName": "Providus Bank",
      "type": "CUSTOMER",
      "isActive": true,
      "createdAt": "2024-01-15T12:00:00Z"
    }
  ],
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": {
      "page": 1,
      "page_size": 25,
      "total": 1,
      "has_more": false
    }
  }
}

List a customer’s transactions

GET /api/v1/business/customers/{id}/transactions

Same pagination params. Returns the collections/transactions attached to the customer’s virtual accounts:

{
  "data": [
    {
      "id": 501,
      "reference": "TXN-2024-xyz",
      "accountNumber": "8012345678",
      "description": "Transfer from John Doe",
      "currency": "NGN",
      "amount": 5000,
      "postingType": "CREDIT"
    }
  ],
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": {
      "page": 1,
      "page_size": 25,
      "total": 1,
      "has_more": false
    }
  }
}

Get a customer’s KYC status

GET /api/v1/business/customers/{id}/kyc

curl "https://api.usenumero.com/numeroaccount/api/v1/business/customers/4021/kyc" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2"

{
  "data": {
    "kycStatus": "VERIFIED"
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}