Skip to main content

CustomerDataNgDrivingLicense

Extends CustomerDataDto: the object also contains its base fields (country, documentType, firstName, lastName and the optional customerId), which are not repeated below. The fields listed here are specific to this country and document type.

middleNamestring

The middle name(s): the given names that follow the first one. The first space or comma ends the first name ("AMINA, ZAINAB" or "AMINA ZAINAB" -> middle name "ZAINAB"), a hyphen does not ("ADA-OBI, ZAINAB" -> first name "ADA-OBI", middle name "ZAINAB"). Optional: sending all the given names together in firstName is also accepted. On the licence the given names follow the surname ("OKORO, DANIEL CHUKWU" -> middle name "CHUKWU"). Every word is fuzzy-matched individually against the OCR. Never fails the match: a middle name the document does not show is reported as not matching in the breakdown, without rejecting the document.

documentNumberstring

The licence number (L/NO) as printed, one token (e.g. "DKA12616AB03"). Spaces are stripped.

birthDate object

Printed DD-MM-YYYY; on temporary licences it may appear only on the back and with slashes (DD/MM/YYYY) — both are handled.

oneOf
number

Unix timestamp in milliseconds

issueDate object

The issue date (ISS), printed DD-MM-YYYY

oneOf
number

Unix timestamp in milliseconds

expirationDate object

The expiration date (EXP), printed DD-MM-YYYY

oneOf
number

Unix timestamp in milliseconds

firstIssueDate object

DATE OF 1st ISS (differs from ISS on renewed licences).

oneOf
number

Unix timestamp in milliseconds

addressstring

The residential address as printed on the licence. Every word is fuzzy-matched individually.

sexstring

The sex of the licence holder — printed short

Possible values: [F, M]

heightstring

The height, canonically as printed (e.g. "1.86M"); "1.86", "1,86", "186" and "186cm" are normalized to it. Fuzzy-matched: the 0.8 threshold on the 4-char value rejects any digit difference (exact with format tolerance).

bloodGroupstring

The blood group (BG), e.g. "O+" or "UNK" as printed

nextOfKinPhonestring

N of K phone number, digits only (e.g. "08172750494"). Spaces are stripped.

licenceClassstring

e.g. "D". Weak single-letter verification; included so Document Analysis extracts it.

CustomerDataNgDrivingLicense
{
  "middleName": "string",
  "documentNumber": "string",
  "birthDate": 0,
  "issueDate": 0,
  "expirationDate": 0,
  "firstIssueDate": 0,
  "address": "string",
  "sex": "F",
  "height": "string",
  "bloodGroup": "string",
  "nextOfKinPhone": "string",
  "licenceClass": "string"
}