Basic Driver's License Verification

The Driver's License Verification API allows users to verify an individual's driver's license number against their basic personal details to ensure identity authenticity.

Base URL

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

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

Endpoint

POST verification/api/v1/idv/basic/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>	API Key or Bearer Token for authentication.
x-api-key	API KEY	API Key for authentication

---

Request Body

The request body should include the individual's driver's license number and basic identity information for verification.

Example Request

{
  "idDocumentNumber": "DL1234567890",
  "dateOfBirth": "1990-08-25",
  "firstName": "Jane",
  "lastName": "Smith",
  "reference": "DL_REF_98765",
  "serviceProviderCode": "SPC002"
}

Request Body Schema

Field	Type	Required	Description
idDocumentNumber	string	✅	The driver's license number of the individual.
dateOfBirth	string	✅	The individual's date of birth in YYYY-MM-DD format.
firstName	string	✅	The individual's first name.
lastName	string	✅	The individual's last name.
reference	string	✅	Unique reference number for the verification request.
serviceProviderCode	string	✅	Code identifying the service provider.

Responses

Success Response (200 OK)

If the verification is successful, the API returns whether the driver's license matches the provided details.

 {
  "apiVersion": "1.0",
  "success": true,
  "code": "00",
  "message": "Verification successful",
  "requestId": "REQ-123456789",
  "data": {
    "isMatch": true,
    "message": "The driver's license matches the provided details."
  }
}

Response Schema

Field	Type	Description
apiVersion	string	API version.
success	boolean	Indicates whether the request was successful.
code	string	Response code.
message	string	Description of the response.
requestId	string	Unique ID for tracking the request.
data.isMatch	boolean	Indicates whether the provided driver's license matches the input details.
data.message	string	Additional information about the match result.

Error Responses

Status Code	Description	Example Response
400	Bad Request	{ "success": false, "message": "Invalid request.", "code": "400" }
401	Unauthorized	{ "success": false, "message": "Unauthorized access.", "code": "401" }
500	Internal Server Error	{ "success": false, "message": "Server error.", "code": "500" }

Usage Example (cURL)

curl -X POST "https://acs-uat-verifications.amala.cloud/verification/api/v1/idv/basic/driverlicense" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "idDocumentNumber": "DL1234567890",
           "dateOfBirth": "1990-08-25",
           "firstName": "Jane",
           "lastName": "Smith",
           "reference": "DL_REF_98765",
           "serviceProviderCode": "SPC002"
         }'