Skip to main content

Malaysian Driving Licence Extraction

Extracts ID number, name, nationality, licence class, validity period and address from a Malaysian driving licence.

POSThttps://sandbox/pcs/MalaysianDL

Content-Type: application/json

Headers​

HeaderTypeRequiredDescription
keystringYesAPI key issued for authentication.

Request body​

FieldTypeRequiredDescription
recordIdstringYesUnique ID you assign to correlate the request with the response.
imagestringYesBase64 string / data URI of the driving licence image.

Example​

POST/pcs/MalaysianDL
curl --location 'https://sandbox/pcs/MalaysianDL' \
--header 'key: <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "recordId": "1",
  "image": "data:image/png;base64,<BASE64_STRING>"
}'
200
{
"status": "success",
"recordId": "1",
"data": {
  "idNumber": "861234567890",
  "name": "name-string",
  "nationality": "MALAYSIA",
  "Class": "B2D",
  "validity": "23/04/2021-23/04/2026",
  "address": "address-string"
},
"utc_time_stamp": "07/11/2024, 07:35:09"
}

Response​

FieldTypeDescription
statusstringsuccess when data was extracted.
recordIdstringEchoes the recordId sent in the request.
data.idNumberstringHolder's identification number.
data.namestringHolder's name.
data.nationalitystringHolder's nationality.
data.ClassstringLicence class(es), e.g. B2D.
data.validitystringValidity period, DD/MM/YYYY-DD/MM/YYYY.
data.addressstringFull address as printed on the licence.
utc_time_stampstringUTC timestamp of the response, DD/MM/YYYY, HH:mm:ss.

Error handling​

200 on success, 422 on a validation error — see Error handling for the common error shape.