Voter's ID - Dojah Inc

curl --request GET \
  "https://api.dojah.io/api/v1/kyc/vin?vin=91F6B1F5BE29535558655586" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "vin": "91F6B1F5BE29535558655586",
});

const url = "https://api.dojah.io/api/v1/kyc/vin?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/kyc/vin",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={ "vin": "91F6B1F5BE29535558655586" },
)
data = res.json()

{
  "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",
    "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"
  }
}

GET/api/v1/kyc/vin

Verify a Voter Identification Number (VIN) and return the registrant’s details from the INEC register.

Headers

Header	Required	Description
`Authorization`	Yes	Your app’s secret key, sent as-is — not `Bearer`.
`AppId`	Yes	The App ID from your dashboard.

Query parameters

Parameter	Type	Required	Description
`vin`	string	Yes	The Voter Identification Number (the lookup key).

Response

Returns an entity with the registrant’s full name, gender, occupation, registration details, polling unit, address, phone, and date of birth.

Errors

Code	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — check your key and `AppId` (no `Bearer` prefix).
`402`	Insufficient wallet balance. Fund your wallet.
`404`	No record found for the supplied identifier.
`424`	The upstream source was unavailable — retry shortly.
`429`	Too many requests — back off and retry.

Sandbox

Test with vin=91F6B1F5BE29535558655586 against https://sandbox.dojah.io. See Sandbox & test data for every test value.

curl --request GET \
  "https://api.dojah.io/api/v1/kyc/vin?vin=91F6B1F5BE29535558655586" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const params = new URLSearchParams({
  "vin": "91F6B1F5BE29535558655586",
});

const url = "https://api.dojah.io/api/v1/kyc/vin?" + params;
const res = await fetch(url, {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/kyc/vin",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    params={ "vin": "91F6B1F5BE29535558655586" },
)
data = res.json()

{
  "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",
    "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"
  }
}