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

# Lookup Voters ID

> Fetch identity details for a Nigerian voter using their Voter Identification Number. Returns name, photo, and other details from the electoral register.

### Request

```http [GET] theme={null}
{{baseUrl}}/api/v1/kyc/vin
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Query parameters

<table id="table"><tbody><tr><td>vin</td><td>string</td><td>Voter's identification number</td><td>optional</td></tr></tbody></table>

### Sample response

```json [200] theme={null}
{
  "entity": {
    "full_name": "JOHN DOE MUSA",
    "voter_identification_number": "91F1234567890123",
    "gender": "Male",
    "occupation": "STUDENT",
    "time_of_registration": "2011-02-18 13:59:46",
    "state": "ONDO",
    "local_government": "IDANRE",
    "registration_area_ward": "",
    "polling_unit": "OJAJIGBOKIN, O/S IN FRONT OF ABANA I & II",
    "polling_unit_code": "12/03/04/005",
    "address": "NO 16 OWODE QTS KABBA",
    "phone": "0812345678",
    "date_of_birth": "1960-10-16"
  }
}
```

### Response Fields

| Field                                | Type   | Description                                            |
| ------------------------------------ | ------ | ------------------------------------------------------ |
| entity                               | object | Contains the voter identity verification response data |
| entity.full\_name                    | string | Full name of the voter as registered                   |
| entity.voter\_identification\_number | string | Voter Identification Number (VIN)                      |
| entity.gender                        | string | Gender of the voter                                    |
| entity.occupation                    | string | Registered occupation of the voter                     |
| entity.time\_of\_registration        | string | Date and time of voter registration                    |
| entity.state                         | string | State where the voter is registered                    |
| entity.local\_government             | string | Local government area of registration                  |
| entity.registration\_area\_ward      | string | Registration area or ward                              |
| entity.polling\_unit                 | string | Name and location of the assigned polling unit         |
| entity.polling\_unit\_code           | string | Unique code identifying the polling unit               |
| entity.address                       | string | Residential address of the voter                       |
| entity.phone                         | string | Phone number of the voter                              |
| entity.date\_of\_birth               | string | Date of birth of the voter (YYYY-MM-DD)                |

### Test Credentials for Sandbox

Kindly use this Test VIN in sandbox Environment

VIN = `91F6B1F5BE29535558655586`