Nigeria

Voter ID

post

Government database lookup API

Header parameters

AuthorizationstringRequired

Bearer token

Body

application/json

identityNumberstring · min: 1Required

dateOfBirthstring · min: 1Required

yyyy-MM-dd

Pattern: [0-9]{4}-[0-9]{2}-[0-9]{2}

lastNamestring · min: 1Required

firstNamestring · min: 1Required

Responses

200

OK

application/json

firstNamestringOptional

lastNamestringOptional

identityNumberstringOptional

genderstringOptional

fullNamestringOptional

occupationstringOptional

pollingUnitCodestringOptional

400

Bad Request: Missing required input or invalid format

application/json

401

Unauthorized: No valid access token has been provided

403

Forbidden: Access token doesn't have permission to use the requested feature

429

Too Many Requests

500

Internal Server Error: Unexpected error

503

Service unavailable: Government database not available

post

/api/v2/id/lookup/nga/voter/id

HTTPcURLJavaScriptPython

POST /api/v2/id/lookup/nga/voter/id HTTP/1.1
Host: id.uqudo.io
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "identityNumber": "text",
  "dateOfBirth": "text",
  "lastName": "text",
  "firstName": "text"
}

{
  "firstName": "text",
  "lastName": "text",
  "identityNumber": "text",
  "gender": "text",
  "fullName": "text",
  "occupation": "text",
  "pollingUnitCode": "text"
}

National Identification Number (NIN)

post

Government database lookup API

Header parameters

AuthorizationstringRequired

Bearer token

Body

application/json

ninstring · min: 1Required

firstNamestring · min: 1Required

lastNamestring · min: 1Required

Responses

200

OK

application/json

faceImagestringOptional

Base64 encoded face image of the user

identityNumberstringOptional

firstNamestringOptional

lastNamestringOptional

dateOfBirthstringOptional

dateOfBirthFormattedstringOptional

ISO-8601 format yyyy-MM-dd

genderstringOptional

phonestringOptional

addressstringOptional

statestringOptional

localGovernmentAreastringOptional

400

Bad Request: Missing required input or invalid format

application/json

401

Unauthorized: No valid access token has been provided

403

Forbidden: Access token doesn't have permission to use the requested feature

429

Too Many Requests

500

Internal Server Error: Unexpected error

503

Service unavailable: Government database not available

post

/api/v2/id/lookup/nga/nin

HTTPcURLJavaScriptPython

POST /api/v2/id/lookup/nga/nin HTTP/1.1
Host: id.uqudo.io
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "nin": "text",
  "firstName": "text",
  "lastName": "text"
}

{
  "faceImage": "text",
  "identityNumber": "text",
  "firstName": "text",
  "lastName": "text",
  "dateOfBirth": "text",
  "dateOfBirthFormatted": "text",
  "gender": "text",
  "phone": "text",
  "address": "text",
  "state": "text",
  "localGovernmentArea": "text"
}

Driving License

post

Government database lookup API

Header parameters

AuthorizationstringRequired

Bearer token

Body

application/json

licenseNumberstring · min: 1Required

dateOfBirthstring · min: 1Required

yyyy-MM-dd

Pattern: [0-9]{4}-[0-9]{2}-[0-9]{2}

Responses

200

OK

application/json

faceImagestringOptional

Base64 encoded face image of the user

licenseNumberstringOptional

firstNamestringOptional

lastNamestringOptional

dateOfBirthstringOptional

dateOfBirthFormattedstringOptional

ISO-8601 format yyyy-MM-dd

dateOfExpirystringOptional

dateOfExpiryFormattedstringOptional

ISO-8601 format yyyy-MM-dd

genderstringOptional

400

Bad Request: Missing required input or invalid format

application/json

401

Unauthorized: No valid access token has been provided

403

Forbidden: Access token doesn't have permission to use the requested feature

429

Too Many Requests

500

Internal Server Error: Unexpected error

503

Service unavailable: Government database not available

post

/api/v2/id/lookup/nga/dl

HTTPcURLJavaScriptPython

POST /api/v2/id/lookup/nga/dl HTTP/1.1
Host: id.uqudo.io
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "licenseNumber": "text",
  "dateOfBirth": "text"
}

{
  "faceImage": "text",
  "licenseNumber": "text",
  "firstName": "text",
  "lastName": "text",
  "dateOfBirth": "text",
  "dateOfBirthFormatted": "text",
  "dateOfExpiry": "text",
  "dateOfExpiryFormatted": "text",
  "gender": "text"
}

BVN (Bank Verification Number)

post

Government database lookup API

Header parameters

AuthorizationstringRequired

Bearer token

Body

application/json

bvnstring · min: 1Required

firstNamestring · min: 1Required

lastNamestring · min: 1Required

Responses

200

OK

application/json

faceImagestringOptional

Base64 encoded face image of the user

bankVerificationNumberstringOptional

firstNamestringOptional

lastNamestringOptional

middleNamestringOptional

phonestringOptional

dateOfBirthstringOptional

dateOfBirthFormattedstringOptional

ISO-8601 format yyyy-MM-dd

genderstringOptional

400

Bad Request: Missing required input or invalid format

application/json

401

Unauthorized: No valid access token has been provided

403

Forbidden: Access token doesn't have permission to use the requested feature

429

Too Many Requests

500

Internal Server Error: Unexpected error

503

Service unavailable: Government database not available

post

/api/v2/id/lookup/nga/bvn

HTTPcURLJavaScriptPython

POST /api/v2/id/lookup/nga/bvn HTTP/1.1
Host: id.uqudo.io
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "bvn": "text",
  "firstName": "text",
  "lastName": "text"
}

{
  "faceImage": "text",
  "bankVerificationNumber": "text",
  "firstName": "text",
  "lastName": "text",
  "middleName": "text",
  "phone": "text",
  "dateOfBirth": "text",
  "dateOfBirthFormatted": "text",
  "gender": "text"
}