> ## 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.

# Verification History

> View past verifications and retrieve detailed results.

View past verifications and retrieve detailed results.

***

## List Verification History

Retrieve a paginated list of all verification requests.

```
GET /api/v1/business/verification/history
```

**Signature required:** No

### Headers

| Header             | Required | Description  |
| ------------------ | -------- | ------------ |
| `X-Numero-Api-Key` | Yes      | Your API key |

### Query parameters

| Parameter          | Type     | Required | Default | Description                                      |
| ------------------ | -------- | -------- | ------- | ------------------------------------------------ |
| `pageNumber`       | integer  | No       | 1       | Page number                                      |
| `pageSize`         | integer  | No       | 20      | Records per page                                 |
| `verificationType` | string   | No       | —       | Filter by type (e.g., `bvn`, `nin`, `cac-basic`) |
| `status`           | string   | No       | —       | Filter by status                                 |
| `startDate`        | datetime | No       | —       | Filter from date                                 |
| `endDate`          | datetime | No       | —       | Filter to date                                   |

### Request example

```bash theme={null}
curl -X GET "https://api.usenumero.com/numeroaccount/api/v1/business/verification/history?pageNumber=1&pageSize=20&verificationType=bvn" \
  -H "X-Numero-Api-Key: your_api_key"
```

### Response

```json theme={null}
{
  "data": [
    {
      "verificationId": 12345,
      "reference": "VER-abc123",
      "type": "bvn",
      "status": "Successful",
      "createdAt": "2024-01-15T10:30:00Z",
      "maskedIdentifiers": "123****8901",
      "walletTransactionReference": "TRX-abc123",
      "walletAmount": 100.0
    }
  ],
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 50,
      "has_more": true
    }
  }
}
```

***

## Get Verification by ID

Retrieve the full details and result of a specific verification.

```
GET /api/v1/business/verification/{id}
```

**Signature required:** No

### Path parameters

| Parameter | Type    | Required | Description         |
| --------- | ------- | -------- | ------------------- |
| `id`      | integer | Yes      | The verification ID |

### Request example

```bash theme={null}
curl -X GET "https://api.usenumero.com/numeroaccount/api/v1/business/verification/12345" \
  -H "X-Numero-Api-Key: your_api_key"
```

### Response

```json theme={null}
{
  "data": {
    "verificationId": 12345,
    "reference": "VER-abc123",
    "type": "bvn",
    "status": "Successful",
    "createdAt": "2024-01-15T10:30:00Z",
    "normalizedResult": {
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "1990-05-15",
      "phoneNumber": "08012345678",
      "gender": "Male"
    },
    "walletTransaction": {
      "reference": "TRX-abc123",
      "amount": 100.0,
      "date": "2024-01-15T10:30:00Z",
      "status": "Successful"
    }
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}
```