> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenumero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Virtual Accounts, Transactions & KYC

> Read the virtual accounts, transactions and KYC status attached to a customer.

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 |

```bash theme={null}
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"
```

```json theme={null}
{
  "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:

```json theme={null}
{
  "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
```

```bash theme={null}
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"
```

```json theme={null}
{
  "data": {
    "kycStatus": "VERIFIED"
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```