Driver's License

Verify a customer’s identity using their Nigerian driver’s license number.

POST /api/onboarding/nigeria_kyc/driver_license/

Driver's License

cURL

curl --request POST \
  --url https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/driver_license/ \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "license_number": "ARR10892UU00",
  "first_name": "EDIKAN",
  "last_name": "EFE",
  "date_of_birth": "1994-08-11"
}
'

400

{
  "status": "failed",
  "data": [
    "<unknown>"
  ],
  "message": "<string>"
}

The Driver’s License endpoint retrieves verified identity information from the FRSC database, including name, date of birth, license validity dates, state of issue, and a photo.

Endpoint

POST /api/onboarding/nigeria_kyc/driver_license/

Request

Headers

Header	Value	Required
x-access-token	Your API secret key	Yes
Content-Type	application/json	Yes

Body Parameters

Parameter	Type	Required	Description
license_number	string	Yes	The customer’s driver’s license number
first_name	string	Yes	First name as on the license
last_name	string	Yes	Last name as on the license
date_of_birth	string	Yes	Date of birth in YYYY-MM-DD format

Example

cURL

curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/nigeria_kyc/driver_license/" \
  -H "x-access-token: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"license_number": "ARR10892UU00", "first_name": "EDIKAN", "last_name": "EFE", "date_of_birth": "1994-08-11"}'

Response

200 OK

Field	Type	Description
data.licenseNo	string	License number
data.lastName	string	Last name
data.firstName	string	First name
data.middleName	string	Middle name
data.gender	string	Gender
data.dateOfBirth	string	Date of birth
data.issuedDate	string	License issue date
data.expiryDate	string	License expiry date
data.stateOfIssue	string	State where license was issued
data.image	string	Base64-encoded license photo

{
  "status": "success",
  "data": {
    "licenseNo": "ARR10892UU00",
    "lastName": "EDIKAN",
    "firstName": "EFE",
    "middleName": "MUNACHI",
    "gender": "male",
    "issuedDate": "2013-10-28",
    "expiryDate": "2018-11-28",
    "stateOfIssue": "OYO",
    "dateOfBirth": "1994-08-11",
    "image": "<base64-encoded-jpeg>"
  },
  "message": "Driver License details retrieved successfully"
}

400 Bad Request

{
  "status": "failed",
  "data": [],
  "message": "Sorry, your check cannot be processed at the moment. Please try again in a few minutes"
}

401 Unauthorized

{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}

Authorizations

x-access-token · string · header · required

Your Adhere API secret key

Body

application/json

license_number · string · required

Driver's license number

Example:

"ARR10892UU00"

first_name · string · required

First name as on the license

Example:

"EDIKAN"

last_name · string · required

Last name as on the license

Example:

"EFE"

date_of_birth · string · required

Date of birth in YYYY-MM-DD format

Example:

"1994-08-11"

Response

200

Driver's license verified