post https://api.datakeen.co/api/v1/reco/driver-license
This synchronous API extracts in real-time information from French driver license document:
Control categories
The control categories returned by the API are the following:
- Data coherency: Verifies the format and the content of the extracted information.
- Visual controls: Verifies the visual conformity of the document.
- Metadata: Verifies the metadata of the file to detect document alterations.
Status codes
The API returns the following status codes:
| Code | Code Name | Description |
|---|---|---|
| 1.0 | conform | The document has been fully verified by the AI, it is valid and conform |
| 2.1 | bluriness | The document could not be processed: Bluriness |
| 2.2 | readability | The document could not be processed: Could not read textual information |
| 4.0 | toVerify | We could not process all the controls on the given document, please review its authenticity |
| 5.0 | AIRejected | At least one element on the document is suspected to be fraudulent |
- Holder’s first name
- Holder’s last name
- Holder’s birth date
- Holder’s birth place
- License issue date
- License issue place
- License expiration date
- License number
- License categories
- MRZ (Machine Readable Zone)
- B license issue date (if existing)
- A license issue date (if existing)
It also extracts control information on the filed above using MRZ :
- Validity of the MRZ : does the MRZ respect document norm criteria
- Conformity of the MRZ : are extracted information from MRZ identical to extraced information from the document
- Checks if the last names match (between document and MRZ)
- Checks if the license numbers match (between document and MRZ)
- Checks if the expiry dates match (between document and MRZ)
The API works on all French licenses but works best on French licenses issued after September 2013.
Maximum file size: 5 MB. Maximum number of calls per minute: 10 calls.
For better results, it is highly recommended to provide documents under these properties :
- The image resolution should be greater than 200 DPI
- The document must not be blurred or rotated
- In case of a photo document, make sure that the text area does not contain any highlights or shadows
- The entire document must be in the frame
