Advance Driver's License Verification

The Advanced Driver’s License Verification API allows you to verify an individual's driver’s license details. This is used for identity validation and fraud prevention.

Base URL

https://acs-uat-verifications.amala.cloud/

https://acs-prod-verifications.amala.cloud/

Endpoint

POST verification/api/v1/idv/advance/driverlicense

Request Headers

You can use either the API key or Bearer Token for Authorization

Header	Type	Description
Content-Type	application/json	Specifies that the request body is in JSON format.
Authorization	Bearer <token>	Bearer Token for authentication.
x-api-key	API KEY	API Key for authentication.

Request Body

The request body should contain driver's license details in JSON format.

Example Request

{
  "idDocumentNumber": "AAD2320823198",
  "dateOfBirth": "1999-12-21",
  "firstName": "test",
  "lastName": "test",
  "reference": "REF123456",
  "serviceProviderCode": "SPC001"
}

Request Body Schema

Field	Type	Required	Description
idDocumentNumber	string	✅	The driver’s license number of the individual.
dateOfBirth	string	✅	Date of birth of the individual (YYYY-MM-DD).
firstName	string	✅	First name of the individual.
lastName	string	✅	Last name of the individual.
reference	string	✅	A unique transaction reference.
serviceProviderCode	string	✅	Code identifying the service provider.

Responses

Success Response (200 OK)

If the driver’s license is valid, the API returns user details as per the GetDetailOfDriversLicenseResponseApiResponse schema.

{
  "apiVersion": "1.0",
  "success": true,
  "code": "00",
  "message": "Verification successful",
  "requestId": "REQ-123456",
  "data": {
    "firstName": "John",
    "lastName": "Doe",
    "middleName": "Michael",
    "gender": "Male",
    "birthDate": "1990-05-15",
    "licenseNo": "DL123456789",
    "issuedDate": "2015-06-20",
    "expiryDate": "2025-06-20",
    "stateOfIssue": "Lagos",
    "photo": "base64-encoded-image-data"
  }
}

Error Responses

Status Code	Description	Example Response
400	Bad Request (Invalid License Number)	{ "success": false, "message": "Invalid license number.", "code": "400" }
401	Unauthorized (Invalid API Key)	{ "success": false, "message": "Unauthorized access.", "code": "401" }
500	Internal Server Error	{ "success": false, "message": "Something went wrong.", "code": "500" }

Usage Example (cURL)

curl -X POST "https://acs-uat-verifications.amala.cloud/verification/api/v1/idv/advance/driverlicense" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "idDocumentNumber": "DL123456789",
           "dateOfBirth": "1990-05-15",
           "firstName": "John",
           "lastName": "Doe",
           "reference": "REF123456",
           "serviceProviderCode": "SPC001"
         }'