Self-hosted API
4.7.0
What's New
- For some documents, the document type was returned as None, which was causing confusion. To prevent this, we are filling in the document type from the barcode in case customers are using BarcodeId mode.
- The fix is applied to all the AAMVA types, plus some others (Argentina, Canada, Colombia, Nigeria, Panama, Paraguay, SouthAfrica).
Added
SUB_FIELD_DESIGNATORadded to theBarcodeElementKeyenum.- Three new management endpoints:
/info,/health, and/health/{selector}(to check forLIVENESSandREADINESS). These last two are also enumerated in theHealthCheckTypecomponent.
4.6.0
What's new
- Added support for capturing the back of US and India passports that feature a barcode.
- Prevent parsing of two-line MRZ in TD1 format unless it's explicitly allowed. This will prevent false positive MRZ extraction on documents where the last line of the MRZ is covered or not fully visible.
API changes
- Added to the
Regionenum:REGION_TELANGANA
- Added to the
FieldTypeenum:MUNICIPALITY_OF_REGISTRATIONLOCALITY_CODEMAIDEN_NAMESTATE_CODEDATE_OF_ENTRYMUNICIPALITY_CODEPOLLING_STATION_CODESECTION_CODEREGISTRATION_CENTER_CODESTATE_NAME
- Added to the
Typeenum:TYPE_EMERGENCY_PASSPORTTYPE_TEMPORARY_PASSPORTTYPE_METIS_FEDERATION_CARDTYPE_ADR_CERTIFICATE
- Added to
BlinkIdMultiSideRecognizerOutput,BlinkIdSingleSideRecognizerOutput, andVIZResultobjects:dateOfEntrylocalityCodemaidenNamemunicipalityCodemunicipalityOfRegistrationpollingStationCoderegistrationCenterCodesectionCodestateCodestateName
- Added to
BlinkIdMultiSideRecognizerOutputandBlinkIdSingleSideRecognizerOutputobjects:fathersNamemothersName
Bugfixes
- Users are no longer forced to scan back sides of Alien and Refugee passports.
- Fixed the issue with Togo ID where document number from VIZ was overridden by a wrong value from MRZ.
New Documents Support
- Angola - Paper Passport
- Bahrain - Polycarbonate Passport
- Burkina Faso - Polycarbonate Passport
- Cameroon - Driver's License
- Canada, Manitoba - Metis Federation Card
- East Timor - Polycarbonate Passport
- El Salvador - Paper Passport
- Eritrea - Paper Passport
- France - Adr Certificate
- Germany - Adr Certificate
- Ghana - Voter ID
- India, Telangana - Driver's License
- Ivory Coast - Paper Passport
- Japan - Polycarbonate Passport
- Liberia - Paper Passport
- Liberia - Voter ID
- Malawi - Identity Card
- Malawi - Paper Passport
- Maldives - Polycarbonate Passport
- Mali - Paper Passport
- Mauritius - Paper Passport
- Oman - Vehicle Registration
- Paraguay - Polycarbonate Passport
- Rwanda - Driver's License
- Senegal - Driver's License
- Sierra Leone - Paper Passport
- Somalia - Paper Passport
- Switzerland - Adr Certificate
- Togo - Driver's License
- Togo - Paper Passport
- USA, Maryland - Medical Marijuana ID
- Vietnam - Paper Passport
New Document Versions for Supported Documents
- Chile - Polycarbonate Passport
- India - Paper Passport
- Moldova - Identity Card
- Pakistan - Identity Card
- Peru - Identity Card
- Romania - Identity Card
- Slovakia - Identity Card
- USA, California - Driver's License
- USA, California - Identity Card
- USA, New Hampshire - Identity Card
- USA, Georgia - Medical Marijuana ID
- USA, Pennsylvania - Medical Marijuana ID
- USA, South Carolina - Driver's License
- USA, South Carolina - Identity Card
- USA, Texas - Driver's License
- USA, Texas - Identity Card
New Segments Supported on Documents
- Switzerland, Residence Permit - 'dateOfEntry'
- Hungary, Identity Card - 'maidenName', 'nationality', 'sexOrGender', 'documentNumber', 'dateOfBirth'
- Greece, Identity Card - 'fathersName' (Latin and Greek), 'mothersName' (Latin and Greek), 'personalIdNumber', 'issuingAuthority' (Greek), 'municipalityOfRegistration' (Greek)
- Mexico, Voter ID - 'sectionCode', 'stateCode', 'municipalityCode', 'localityCode'
- Mexico, Consular Voter ID - 'stateCode', 'stateName'
Renamed segments
- Hungary - Identity Card -
additionalNameInformation->mothersName
4.5.0
What's New
- Updated detection analysis logic in case of photo mode
- Added new
parsedresult member to theBarcodeResultwhich indicates whether the raw barcode data was successfully parsed
Bugfixes
- Fixed the issue with scanning the back of the Essad Card which was causing only Date of Expiry to be extracted
- Fixed the issue with
additionalNameInformationextraction for France ID and Residence Permit
4.4.0
New Documents Support
- Canada, Newfoundland And Labrador - Identity Card
- Canada, Northwest Territories - Driver's License
- Canada, Northwest Territories - Identity Card
- Canada, Prince Edward Island - Identity Card
- Canada, Yukon - Identity Card
New Document Versions for Supported Documents
- Canada, Yukon - Driver's License
API Changes
dependentsInfoinVizResultis now nullable
4.3.0
What's new
- Improved extraction for Canada/Nunavut ID and DL by introducing error correction for "1" and "I" characters which look the same in the font used on a document
API changes
- Added to the
FieldTypeenum:NATIONAL_INSURANCE_NUMBERCOUNTRY_CODECERTIFICATE_NUMBER
- Added to
Typeenum:TYPE_NON_CARD_TRIBAL_IDTYPE_DIPLOMATIC_ID
- Added to
BlinkIdMultiSideRecognizerOutput,BlinkIdSingleSideRecognizerOutput, andVIZResultobjects:certificateNumbercountryCodenationalInsuranceNumber
Bugfixes
- Fixed document number extraction from Canada/Nunavut barcodes
- Fix for ARGENTINA ID and ALIEN_ID documents - made separate barcode scanning step optional for these documents. They have a barcode on the front side, and requiring barcode extraction was causing the scanning process to get stuck on the front.
New Documents Support
- Canada, Nunavut - Driver's License
- Canada, Nunavut - Identity Card
- Liberia - Identity Card
- Mali - Identity Card
- UK - Military ID
New Document Versions for Supported Documents
- Bahrain - Identity Card
- Canada - Weapon Permit
- Chile - Alien ID
- Chile - Identity Card
- Finland - Driver's License
- Indonesia - Driver's License
- Kosovo - Identity Card
- Latvia - Polycarbonate Passport
- Mexico, Chiapas - Driver's License
- Mexico, Ciudad de Mexico - Driver's License
- Mexico, Durango - Driver's License
- Mexico, Jalisco - Driver's License
- Sri Lanka - Driver's License
- USA, Alaska - Driver's License
- USA, New Hampshire - Driver's License
- European Union - Health Insurance Card
New Beta Documents Support
- Canada - Non Card Tribal ID
- Dominica - Paper Passport
- Dominica - Polycarbonate Passport
- UAE - Diplomatic ID
- USA, Georgia - Medical Marijuana ID
New Document Versions for Beta-Supported Documents
- Egypt - Driver's License
- Mexico, Quintana Roo - Driver's License
- Philippines - Postal ID
- Vietnam - Identity Card
New Segments Supported on Documents
- European Union, Health Insurance Card -
countryCode - Italy, Identity Card -
documentOptionalAdditionalNumber - France, Identity Card -
additionalNameInformation - UK, Asylum Request -
residencePermitType,remarks - UK, Residence Permit -
residencePermitType,remarks,certificateNumber,nationalInsuranceNumber
Renamed segments
- Bahrain - Identity Card -
documentNumber->personalIdNumber
4.2.1
Bug Fixes
- Fixed a bug in which location strings would show up as "Infinity" in the response. This has been fixed for all scripts:
latinLocationcyrillicLocationarabicLocationgreekLocation
4.2.0
Bug Fixes
- Fixed data match bug when partial anonymization is enabled
- Fixed face extraction bug for rotated face images on documents
- Improved face extraction for documents without face image (skipping face image extraction in that case)
- Fixed face extraction bug for Philippines Passport document
- Properly fill ProcessResult during the Barcode Capture step, ensuring only relevant fields are filled
- Fixed bug that forced scanning of the back side of the Germany Residence Permit in passport document
- Fixed bug that caused skipping back side when only signature was present
4.1.0
New Documents Support
- Austria - Refugee Passport
- Austria - Polycarbonate Refugee Passport
- Burkina Faso - Driver's License
- Burkina Faso - Paper Passport
- Costa Rica - Residence Permit
- Gambia - Paper Passport
- Guinea - Polycarbonate Passport
- Rwanda - Polycarbonate Passport
- South Korea - Polycarbonate Passport
- Tanzania - Polycarbonate Passport
- Uganda - Paper Passport
- Uganda - Polycarbonate Passport
- Zambia - Driver's License
- Zambia - Paper Passport
- USA, Florida - Medical Marijuana ID
- USA, Pennsylvania - - Medical Marijuana ID
New Document Versions for Supported Documents
- Bangladesh - Second data page support on Paper Passport and Polycarbonate Passport
- Kosovo - Paper Passport
- Mexico, Colima - Driver's License
- Mexico, Mexico - Driver's License
- Netherlands - Identity Card
- Netherlands - Polycarbonate Passport
- Romania - Identity Card, Back side scanning
- Romania - Polycarbonate Passport
- Singapore - Employment Pass, Back side scanning
- Slovakia - Polycarbonate Passport
- Syria - Paper Passport
New Beta Documents Support
- Benin - Paper Passport
- Burundi - Polycarbonate Passport
- Chad - Identity Card
- Kenya - Driver's License
- Mozambique - Polycarbonate Passport
- Spain - Registration Certificate
- Sudan - Identity Card
- Zimbabwe - Driver's License
- USA, Nevada - Medical Marijuana ID
- USA, New York - Medical Marijuana ID
- USA, Oklahoma - Medical Marijuana ID
New Document Versions for Beta-Supported Documents
- Mexico, Guanajuato - Driver's License
- Mexico, Puebla - Driver's License
- Croatia - Health Insurance Card
New Segments Supported on Documents
- Greece
- Identity Cards, Driver's Licenses, Residence Permits and Passports
- expanding support for extracting segments in Greek script
- Saudi Arabia, Identity Card
- expanding support for extracting segments in Arabic script
- Egypt, Driver's Licenses
- expanding support for extracting segments in Arabic script
4.0.0
What's New
-
Removed ID barcode endpoint
/id-barcodeendpoint has now been removed from the API. If you previously relied on the/id-barcodeendpoint, use/blinkid-single-sideinstead.
-
Improved error handling:
- If a request is made to an endpoint that is not supported by the provided license key, the API will now return an error message
Recognizer Not Supported by License.
- If a request is made to an endpoint that is not supported by the provided license key, the API will now return an error message
-
Backward compatibility
- Existing production keys will continue to work with version 3.15.0. No new license key is required for the upgrade.
-
Security improvements
- Updated major frameworks and libraries.
- Updated base image to enhance security and performance.
Major API Changes
Note: In addition to API functionality changes, the provided OpenAPI schemas may also contain syntactic differences which don't affect the usage of the API.
Request
The request structure has been updated to improve clarity. Changes include renamed request properties, newly added properties, and removed properties. Ensure your integration reflects these changes.
Renamed Properties
To align with our naming conventions, request properties have been updated:
imageFront→imageFirstSideimageBack→imageSecondSideenableBlurFilter→skipImagesWithBlurallowBarcodeScanOnly→enableBarcodeScanOnlyscanUnsupportedBack→scanUnsupportedSecondSideallowUncertainFrontSideScan→allowUncertainFirstSideScanvalidateResultCharacters→enableCharacterValidationadditionalAnonymization→customDocumentAnonymizationSettingsskipUnsupportedBack→scanUnsupportedSecondSidecustomClassRules→customDocumentRules(changed type fromClassFiltertoDocumentFilter)
Added Properties
enableBarcodeScanOnly- Allows barcode recognition to proceed even if initial extraction fails.enableCharacterValidation- Ensures extracted characters meet expected formats.customDocumentRules- Allows defining custom document processing rules.skipImagesWithBlur- Filters out blurry images to improve recognition accuracy.skipImagesWithInadequateLightingConditions- Filters out images with poor lighting.skipImagesOccludedByHand- Skips images that are partially covered by a hand.customDocumentAnonymizationSettings- Allows setting custom anonymization settings per document type.
Removed Properties
allowUnverifiedMrzResults- No longer needed as both verified and unverified MRZ will always be returned. You can use theverifiedboolean field in themrzDataresponse to check whether the MRZ was valid or not. We define MRZ to bevalidif check digits in the MRZ are correct.validateResultCharacters- Replaced byenableCharacterValidation.allowBarcodeScanOnly- Now replaced byenableBarcodeScanOnly.enableBlurFilter- Now handled byskipImagesWithBlur.additionalAnonymization- Moved or consolidated intocustomDocumentAnonymizationSettings.customClassRules- Removed from request settings.allowUnparsedMrzResults- No longer needed as the new and improved MRZ parser will now always return the result, as long as OCR returns the MRZ characters. If MRZ cannot be parsed, themrzDataresponse will benull.
Response
The response structure has been updated for consistency with the new request structure. Changes include renamed response properties, newly added properties, and removed properties. Be sure to adjust your processing logic accordingly.
Renamed Properties
To align with our naming conventions, response properties have been renamed:
fullDocumentFrontImageBase64→fullDocumentFirstSideImagefullDocumentBackImageBase64→fullDocumentSecondSideImagefrontViz→firstSideVizbackViz→secondSideVizfrontImageAnalysisResult→firstSideImageAnalysisResultbackImageAnalysisResult→secondSideImageAnalysisResultfrontProcessingStatus→firstSideProcessingStatusbackProcessingStatus→secondSideProcessingStatusfrontAdditionalProcessingInfo→firstSideAdditionalProcessingInfobackAdditionalProcessingInfo→secondSideAdditionalProcessingInfoglareDetected→glareDetectionStatusblurDetected→blurDetectionStatuscardOrientation→documentOrientationcardRotation→documentRotationclassInfo→documentClassInfobelowAgeLimit→isBelowAgeLimit- In the
ProcessingStatusobject:CLASS_FILTERED→DOCUMENT_FILTEREDUNSUPPORTED_CLASS→UNSUPPORTED_DOCUMENT
- The
LocationInfo.sideobject now usesFIRSTandSECONDinstead ofSIDE_FRONTandSIDE_BACK
Added Properties
fullDocumentImage- Stores the full image of the document.signatureImage- Stores the extracted signature image.faceImage- Stores the extracted face image.verified- Boolean in MrzResult that is true if all check digits inside MRZ are correct, false otherwise.
Removed Properties
fullDocumentImageBase64- Now stored infullDocumentImage.faceImageBase64- Now stored infaceImage.faceImageLocation- Now stored infaceImagesignatureImageBase64- Now stored insignatureImage.UNSUPPORTED_BY_LICENSEvalue in theProcessingStatusobject
Plan Your Upgrade
For any questions or feedback, reach out to support@microblink.com. We value your input and look forward to hearing how the new BlinkID improves your app’s experience!
3.15.0
New Documents Support
- Benin - Identity Card
- Costa Rica - Polycarbonate Passport
- Gambia - Identity Card
- Guinea - Identity Card
- Nicaragua - Paper Passport
- Pakistan - Polycarbonate Passport
- Saudi Arabia - Polycarbonate Passport
- Senegal - Paper Passport
- Suriname - Identity Card
- Uruguay - Paper Passport
- Zimbabwe - Polycarbonate Passport
New Document Versions for Supported Documents
- Australia, Northern Territory - Proof Of Age Card
- Ecuador - Driver's License
- Ecuador - Paper Passport
- El Salvador - Identity Card
- Finland - Identity Card
- Germany - eID
- Greece - Driver's License
- Guatemala - Driver's License
- Kenya - Identity Card
- Luxembourg - Residence Permit
- Mexico, Hidalgo - Driver's License
- Mexico, Quintana Roo-Solidaridad - Driver's License
- Mexico, Tamaulipas - Driver's License
- Mozambique - Identity Card
- New Zealand - Driver's License
- Nicaragua - Identity Card
- Tunisia - Driver's License
- Uganda - Driver's License
- UK - Asylum Request
- UK - Proof Of Age Card
- USA - Passport Card
- USA, Michigan - Identity Card
- USA, Tennessee - Driver's License
- USA, Tennessee - Identity Card
New Beta Documents Support
- Brazil, Alagoas - Identity Card
- Grenada - Paper Passport
- Honduras - Resident ID
- Paraguay - Paper Passport
- Saint Kitts and Nevis - Paper Passport
- UAE - Esaad Card
New Document Versions for Beta-Supported Documents
- El Salvador - Driver's License
- Honduras - Driver's License
- Hong Kong - Polycarbonate Passport
- India, Gujarat - Driver's License
- Liechtenstein - Driver's License
- Mexico, Quintana Roo-Cozumel - Driver's License
- Mozambique - Driver's License
- Saint Lucia - Paper Passport
Out of beta
- UK - Asylum Request
- USA, North Dakota - Identity Card
Bug Fixes
- NY ID/DL: Added logic to expose the Enhanced document subtype, allowing customers to distinguish between regular and enhanced versions.
- Bolivia & Namibia ID: Resolved data match inconsistencies that were causing data match failures.
- Romanian ID: Multi side scan no longer expects blank back card of old IDs, even with
skipUnsupportedBackset tofalse. - Fixed
backImageAnalysisResult.cardRotationnot being correctly populated when scanning the wrong side of a document.
3.14.0
What's New
- Beta Feature: Second Page Passport Scanning
- We’ve launched support for scanning and extracting data from the second page of passports for select countries - Slovenia, Ireland, and New Zealand. By default, this feature is disabled but can be enabled via the
scanPassportDataPageOnlysetting. This feature is in beta, and your feedback is appreciated.
- We’ve launched support for scanning and extracting data from the second page of passports for select countries - Slovenia, Ireland, and New Zealand. By default, this feature is disabled but can be enabled via the
- USA Green Card - Enabled Data Match for the
Document Numberfield, matching values from the VIZ (Visual Inspection Zone) and MRZ to further enhance extraction reliability.
Bug Fixes
- Spain ID: Fixed an issue with indefinite expiry dates, ensuring consistent values between the MRZ and Visual Inspection Zone (VIZ).
- Bulgaria ID: Improved parsing for indefinite expiry dates in the MRZ for better accuracy.
- Netherlands ID & Norway Passport: Resolved issues with the
Personal ID numberfield that were causing the data match feature to fail. - Chinese Passport: Enhanced reliability of extracted data with additional logic for the
Document Numberfield. - German ID & Luxembourg ID: Adjusted name extraction logic to resolve issues with name separation, ensuring more consistent results.
3.13.1-lite
Bug fixes
- NYC Municipal ID & USA Border Crossing Card - Resolved an issue where the scanning process could get stuck on the back side during multi-side scanning
3.13.0-lite
New Documents Support
- Armenia - Paper Passport
- Bahamas - Temporary Residence Permit
- Bahamas - Work Permit
- Bangladesh - Polycarbonate Passport
- Comoros - Paper Passport
- Dominican Republic - Non Voter ID
- Greece - Polycarbonate Passport
- Jamaica - Voter ID
- Kazakhstan - Paper Passport
- Kyrgyzstan - Paper Passport
- Kyrgyzstan - Polycarbonate Passport
- Lebanon - Driver's License
- Tajikistan - Identity Card
- Turkmenistan - Polycarbonate Passport
- Uzbekistan - Identity Card
New Document Versions for Supported Documents
- Argentina - Alien ID
- Bulgaria - Identity Card
- Canada, British Columbia - Identity Card
- Canada, British Columbia - Minors Public Services Card
- Croatia - Driver's License
- Jamaica - Paper Passport
- Malaysia - i-Kad
- Mexico, Coahuila - Driver's License
- Montenegro - Driver's License
- Namibia - Identity Card
- Norway - Driver's License
- Pakistan - Proof of Registration
- Panama - Identity Card
- Panama - Residence Permit
- Peru - Minors ID
- Portugal - Identity Card
- Romania - Identity Card
- Trinidad and Tobago - Driver's License
- Turkey - Identity Card
- USA, Arizona - Identity Card
- USA, Colorado - Identity Card
- USA, Michigan - Identity Card
- USA, Mississippi - Driver's License
- USA, Mississippi - Identity Card
- USA, Montana - Identity Card
- USA, North Carolina - Identity Card
- USA, North Carolina - Driver's License
- USA, North Dakota - Driver's License
- USA, Vermont - Identity Card
- USA, Virginia - Identity Card
- USA, Wyoming - Driver's License
- USA, Wyoming - Identity Card
- Uzbekistan - Paper Passport
New Beta Documents Support
- Andorra - Paper Passport
- Andorra - Polycarbonate Passport
- Philippines - Driver's License
- Armenia - Work Permit
- Australia - Asic Card
- Azerbaijan - Driver's License
- Bahamas - Paper Passport
- Bahamas - Polycarbonate Passport
- Cayman Islands - Paper Passport
- Cayman Islands - Polycarbonate Passport
- Cayman Islands - Voter ID
- Gibraltar - Driver's License
- Gibraltar - Identity Card
- Gibraltar - Paper Passport
- Gibraltar - Polycarbonate Passport
- Guyana - Paper Passport
- Kuwait - Bidoon Card
- Kyrgyzstan - Driver's License
- Monaco - Paper Passport
- Pakistan - Afghan Citizen Card
- Philippines, Bangsamoro - Driver's License
- Saint Lucia - Driver's License
- Saint Lucia - Paper Passport
- San Marino - Polycarbonate Passport
- Turks and Caicos Islands - Driver's License
- Turks and Caicos Islands - Identity Card
- Turks and Caicos Islands - Paper Passport
- Australia - Interim Health Insurance Card
- Australia - Reciprocal Health Insurance Card
- UAE - Vehicle Registration
New Document Versions for Beta-Supported Documents
- Barbados - Identity Card
- Brazil - Paper Passport
- Dominican Republic - Driver's License
- India, Gujarat - Driver's License
- Mexico, Puebla - Driver's License
- Philippines - Tax ID
- Philippines - Health Insurance Card
- Australia - Health Insurance Card
New Segments Supported on Documents
- USA - Green Card -
eligibilityCategory - USA - Work Permit -
eligibilityCategory - Greece - Driver's License -
placeOfBirth(greek and latin) - Saudi Arabia - Resident ID -
nationality(arabic) - Bahrain -
dateOfExpiry - USA - Driver's license & ID card -
specificDocumentValidity - Pakistan - Proof of Registration -
DependentDateOfBirth,DependentSex,DependentDocumentNumber&DependentFullName
Renamed segments
- Barbados - Identity Card -
personalIdNumber->documentNumber - Panama - Identity Card -
personalIdNumber->documentNumber - Panama - Residence Permit -
personalIdNumber->documentNumber
New Features
- Greek Alphabet Support
- We’ve added support for extracting
Place of Birthin both Greek and Latin scripts.
- We’ve added support for extracting
- The Quite OK Image Format
- introduced
QOIimage format for result images - ImageFormat enum has now new value:
QOI
- introduced
3.12.0-lite
New features
- Ability to choose image format
- You can now select the image format in which BlinkID returns images, with options for JPG and PNG. This new setting allows you to tailor the image output to meet the specific requirements of your use case, providing flexibility in balancing image quality and file size.
New document versions for supported documents
- Sweden - Social Security Card - Back side
- Bolivia - Driver's License - Back side
- Brazil, Distrito Federal - Identity Card - Back side
Out of beta
- Colombia - Temporary Protection Permit
New beta documents support
- France - Professional ID
- Mexico - Tax ID
New document versions for beta-supported documents
- Brazil, Parana - Identity Card - Back side
- Brazil, Santa Catarina - Identity Card - Back side
New segments supported on documents
- Peru - Alien ID - MRZ
Bug fixes
- Fallback for barcode scanning -
Barcode IDrecognition mode will now extract information from any supported barcode if full document recognition fails. Initially available only for US and Canadian documents, this feature is now available to all documents. - MRZ field on US documents - Set to optional by default and currently refers to: Minnesota (DL & ID), New York (DL & ID), Vermont (DL) and Washington (DL & ID).
AdditionalProcessingInfo- In cases of an empty result, this field now provides details about the reasons why scanning failed.
3.11.0-lite
New Features
- Custom mandatory fields
- We’re introducing the option for customers to define their own set of mandatory fields. This feature allows greater flexibility in the scanning process by enabling the extraction of only the necessary information from identity documents. Now you can customize the process and focus on only those fields that are relevant to your use case.
- Custom mandatory fields can be set at the document level or applied universally to all document types.
- Face detector improvements
- We made significant enhancements to our face detector model. If BlinkID can not detect a complete face image, it will prompt users with real-time feedback "Keep the document fully visible."
- Added new values to
Class Infoenum:- Region:
ALAGOASfor Brazilian documents - Type:
AFGHAN_CITIZEN_CARD,EID,PASS,SIS_ID
- Region:
API breaking change
- Additional anonymization
- The ClassAnonymizationSettings class used for additional anonymization now includes a ClassFilter for filtering classes by Country, Region, and Type.
- example of old additionalAnonymization JSON structure:
"additionalAnonymization": [
{
"country": "COUNTRY_USA",
"region":"REGION_CALIFORNIA",
"type": "TYPE_DL",
"fields":["FIRST_NAME"]
}
] - example of new additionalAnonymization JSON structure:
"additionalAnonymization": [
{
"classFilter": {
"country": "COUNTRY_USA",
"region": "REGION_CALIFORNIA",
"type": "TYPE_DL"
},
"fields": ["FIRST_NAME"]
}
]
New Documents Support
- Austria - Polycarbonate Passport
- Canada - Polycarbonate Passport
- Ecuador - Paper Passport
- Germany - eID
- Guatemala - Alien ID
- Iraq - Polycarbonate Passport
- Namibia - Identity Card
- Nepal - Polycarbonate Passport
- Sweden - SIS ID
- USA, Delaware - Identity Card
- USA, Louisiana - Identity Card
- USA, Vermont - Identity Card
New Document Versions for Supported Documents
- Bolivia - Identity Card
- Canada, British Columbia - Public Services Card
- Finland - Identity Card
- Greece - Identity Card
- Malaysia - iKAD
- Mexico, Nuevo Leon - Driver's License
- Mexico, Tlaxcala - Driver's License
- Morocco - Driver's License
- Thailand - Polycarbonate Passport
- USA - Alaska - Driver's License
- USA - Alaska - Identity Card
- USA - Connecticut - Identity Card
- USA - Delaware - Driver's License
- USA - District of Columbia - Driver's License
- USA - Hawaii - Identity Card
- USA - Idaho - Driver's License
- USA - Indiana - Driver's License
- USA - Indiana - Identity Card
- USA - Iowa - Identity Card
- USA - Kansas - Identity Card
- USA - Kentucky - Identity Card
- USA - Kentucky - Driver's License
- USA - Maine - Identity Card
- USA - Maine - Driver's License
- USA - Michigan - Driver's License
- USA - Minnesota - Driver's License
- USA - Minnesota - Identity Card
- USA - Montana - Identity Card
- USA - Montana - Driver's License
- USA - New Hampshire - Identity Card
- USA - New Mexico - Driver's License
- USA - New Mexico - Identity Card
- USA - New York - Identity Card
- USA - North Dakota - Identity Card
- USA - Oregon - Identity Card
- USA - Pennsylvania - Driver's License
- USA - Rhode Island - Identity Card
- USA - South Carolina - Identity Card
- USA - Vermont - Driver's License
- USA - Washington - Identity Card
- USA - Wyoming - Driver's License
- USA - Wyoming - Identity Card
Out of Beta
- European Union - Health Insurance Card
New Beta Documents Support
- Democratic Republic of the Congo - Voter ID
- Philippines - Alien ID
- Philippines - Postal ID
- Philippines - Work Permit
- Philippines - Health Insurance Card
New Document Versions for Beta-Supported Documents
- Honduras - Paper Passport
- Mexico, Sonora - Driver's License
- Peru - Alien ID
- Philippines - Alien ID
New Segments Supported on Documents
- China Exit Entry Permit - MRZ
- China Mainland Travel Permit Taiwan - MRZ
- France Residence permit -
Remarks&ResidencePermitType - Philippines Alien ID -
visaType
Bug Fixes
- German ID - Fixed issues in cases when documents contain multiple surnames.
- Paraguay ID - Added support for parsing the smaller barcode found on the back side of the ID.
- Bulgaria Driver’s License - The Address field is set to optional, improving the extraction process.
- Improved MRZ parsing for the back side of the following identity documents:
- Brazil Alien ID
- Kenya ID
- Bosnia and Herzegovina ID
- Ivory Coast ID
- Paraguay ID
3.10.0-lite
New Features
- Glare detection
- We’ve introduced glare detection to BlinkID.
- Improved blur detection
- We’ve raised the threshold for our blur model, making it stricter. This improvement ensures that sharper images are accepted for processing. You can disable blur filtering by setting the
enableBlurFilter(ex.allowBlurFilter) boolean parameter tofalse.
- We’ve raised the threshold for our blur model, making it stricter. This improvement ensures that sharper images are accepted for processing. You can disable blur filtering by setting the
- Support for extracting the subtypes of US driver’s licenses & ID cards
- BlinkID now extracts precise information about subtypes of driver’s licenses and ID cards (e.g., conditional driver’s license, learner’s permit, provision, enhanced, etc.). This information is included in the scanning results, allowing you to tailor workflows or processes based on document limitations.
- Option to anonymize barcode data
- You can now anonymize specific fields in the barcode results from an identity document, in addition to the anonymized fields already supported in the Visual Inspection Zone (VIZ).
Minor API changes
- Added a new result member
documentSubtypein BlinkIDSingleSideResponse, BlinkIDMultiSideResponse, and VIZResult to include subtype information for US driver’s licenses or ID cards (commercial, provisional, etc.) - Renamed setting
allowBlurFiltertoenableBlurFilter - Changes to the
ImageAnalysisResult:- added boolean
glareDetected - renamed
blurredtoblurDetected
- added boolean
Bug Fixes
- Fixed data match for Paraguay ID 2023 to cover inconsistencies between the MRZ and Visual Inspection Zone (VIZ)
3.9.1-lite
Bug Fixes
- Fixed document number anonymization bug
3.9.0-lite
New Features
- Real ID symbol detection on US driver's license
- BlinkID can now identify Real ID symbols from US driver’s licenses, providing feedback on their presence or absence. This ensures customers can quickly determine if a Real ID symbol is available on a scanned US driver’s license to be compliant with Real ID regulations..
- Partial anonymization of the "Document Number"
- To ensure user privacy and security, BlinkID now offers the option of partially anonymizing the document number from the scanned document.
- Mandatory Barcode Presence on US documents
- To minimize the cases of capturing the front side of the document as the back frame in the results, BlinkID now requires the presence of a barcode before saving the back frame on US documents. Processing status
BarcodeDetectionFailedis returned when the mandatory barcode is not present on the back of US documents.
- To minimize the cases of capturing the front side of the document as the back frame in the results, BlinkID now requires the presence of a barcode before saving the back frame on US documents. Processing status
Minor API changes
- Added
BarcodeDetectionFailedas a newProcessingStatus- This status is triggered once the barcode was not found on the image. This processing status can only occur if the document has the mandatory barcode.
- Added new boolean member
realIdDetectionStatusto theImageAnalysisResult. Iftrue, Real ID symbol is present,falseotherwise. - Added new member
documentNumberAnonymizationSettingsto theClassAnonymizationSettingsfor seamless integration with the document number anonymization feature.
Bug Fixes
- Updated internal mapping for Myanmar Passports to display nationality as "Myanmarese" instead of "Burmese" on Myanmar passports.
3.8.0-lite
Changes to BlinkID(Combined) Recognizer
- Added support for extraction of
sponsorandbloodTypein vizResult
Added support for 7 new documents:
- Australia - Polycarbonate Passport
- Indonesia - Polycarbonate Passport
- Mexico - Consular Voter ID
- Moldova - Polycarbonate Passport
- Pakistan - Proof Of Registration
- Panama - Polycarbonate Passport
- USA - West Virginia - ID Card
Added support for 10 new documents in BETA:
- Brazil - Ceara - ID Card
- Brazil - Goias - ID Card
- Brazil - Sergipe - ID Card
- China - Exit Entry Permit
- China - Mainland Travel Permit Taiwan
- Colombia - Temporary Protection Permit
- India - DL
- India - Andhra Pradesh - DL
- India - Haryana - DL
- European Union - Health Insurance Card
Added new version support for 37 already supported documents
- Australia - Queensland - DL
- Australia - Victoria - DL
- Australia - Western Australia - DL
- Bolivia - Minor's ID
- Brazil - Alien ID
- Estonia - DL
- Finland - Alien ID
- Guatemala - Paper Passport
- India - Paper Passport - New side type
- Malta - DL
- Mexico - Guanajuato - DL
- Mexico - San Luis Potosi - DL
- New Zealand - Polycarbonate Passport
- Paraguay - ID Card
- Slovenia - Residence Permit
- USA - Green Card
- USA - Work Permit
- USA - Arizona - ID Card
- USA - Colorado - DL
- USA - Colorado - ID Card
- USA - District of Columbia - DL
- USA - District of Columbia - ID Card
- USA - Idaho - DL
- USA - Idaho - ID Card
- USA - Missouri - ID Card
- USA - Nebraska - ID Card
- USA - Nevada - ID Card
- USA - New York - ID Card
- USA - North Dakota - DL
- USA - Oklahoma - ID Card
- USA - Pennsylvania - ID Card
- USA - Utah - ID Card
- USA - Virginia - DL
- USA - Virginia - ID Card
- USA - West Virginia - DL
- USA - Wisconsin - DL
- USA - Wisconsin - ID Card
Added new version support for 7 already supported documents in BETA:
- Australia - Queensland - Proof of Age Card
- Brazil - ID Card
- Ireland - Residence Permit
- Mexico - Consular ID
- Mexico - Residence Permit
- Mexico - Nayarit - DL
- USA - North Dakota - ID Card
These documents are no longer BETA:
- Croatia - Residence Permit
- Moldova - Paper Passport
3.7.0
Improvements
- Added support for extraction of
visaTypeandnumberOfEntriesfrom visas
3.6.0-lite
Bugfixes
- Fixed data matching issue in Guatamala Passport
- Improved the document side detection for US driver licenses which reduces the possibility of capturing the wrong side of the document. Barcode is now mandatory for the document back side of the US driving licenses
Changes to BlinkCardRecognizer
- Improved scanning performance and added support for virtually any card layout
- Improved IBAN parser which now supports more IBAN formats
- Added option
allowInvalidCardNumberwhich allows reading invalid card numbers to avoid endless scanning on samples and test cards:- use with care as it might reduce accuracy in certain situations in production
- for invalid card number the flag
cardNumberValidindatawill be set tofalse
Improvements
- Better support for RTL languages in our default UX
3.5.0-lite
New features
- New
CardOrientationstatus -NotAvailable - New
Regionenum values:DISTRITO_FEDERALMARANHAOMATO_GROSSOMINAS_GERAISPARAPARANAPERNAMBUCOSANTA_CATARINA
- New
Typeenum values:CONSULAR_VOTER_IDTWIC_CARD
3.4.0-lite
New features
- Changes to the
BlinkIdSingleSideRecognizerandBlinkIdMultiSideRecognizer:- added new structure LocationInfo (with
topLeftCorner,dimensions,sidemembers) - added new result members inside
StringResult:latinLocation- location of latin recognitioncyrillicLocation- location of cyrillic recognitionarabicLocation- location of arabic recognition
- new result member in
BlinkIdSingleSideRecognizerOutputandBlinkIdMultiSideRecognizerOutput:faceImageLocation
- added new structure LocationInfo (with
- Add new
Countryenum value -SCHENGEN_AREA - And new
Typeenum value -IMMIGRANT_VISA
Bugfixes
- Remove autofill on
RussianpassportDateOfExpirywhen present on a document - Improved scanning success rate and stability when using
BlinkIdMultiSideRecognizer
3.3.0
New features
- support for visa documents
- fix for data match for Korean Passport
- postprocessing of full name for France Residence Permit
- data is split to first name and last name
- added new items to enums:
- Country:
- SCHENGEN_AREA
- Type:
- IMMIGRANT_VISA
- FieldType:
- durationOfStay
- numberOfEntries
- visaType
- Country:
Added support for 8 new documents in BETA
- Canada - Visa
- China - Visa
- India - Visa
- Schengen Area - Visa
- UK - Visa
- USA - Immigrant Visa
- USA - Visa
- UAE - Residence Permit
Improvements
- Included hand, photocopy, and screen detection models to achieve liveness functionality
- Added anonymization info on which side was anonymized. String data is anonymized using an asterisk instead of blanking the result.
- Expanded the number of supported credit card types by 100%.
- Improved data extraction, including a 30% reduction in incorrect processing of CVV field.
3.2.0
New features
- new and improved machine learning models for data extraction
- expanded support for arabic documents
- added isFilledByDomainKnowledge flag to Date and DateResult
- indicates that date is not extracted from image but filled based on our internal document knowledge
- added new setting additionalAnonymization
- enables custom anonymization for any field per country, region and type of document
- added new items to enums:
- Region:
- NORTHWEST_TERRITORIES (added item to enum, no document support for NORTHWEST_TERRITORIES yet)
- NUNAVUT (added item to enum, no document support for NUNAVUT yet)
- PRINCE_EDWARD_ISLAND
- Type:
- ASYLUM_REQUEST
- DRIVER_QUALIFICATION_CARD
- PROVISIONAL_DL
- REFUGEE_PASSPORT
- SPECIAL_ID
- UNIFORMED_SERVICES_ID
- FieldType:
- BloodType
- Sponsor
- Region:
Added support for 9 new documents
- Belarus - ID Card
- Guyana - ID Card
- Jamaica - Paper Passport
- Myanmar - Paper Passport
- Palestine - Paper Passport
- Saint Kitts and Nevis - Driving License
- Syria - ID Card
- Trinidad and Tobago - Paper Passport
- USA - Uniformed Services ID Card
Added support for 23 new documents in BETA
- Barbados - Driving License
- Belarus - Polycarbonate Passport
- Belarus - Residence Permit
- Belgium - Provisional Driving License
- Belgium - Special ID Card
- Bulgaria - Alien ID Card
- Bulgaria - Residence Permit
- Canada - New Brunswick - ID Card
- Canada - Prince Edward Island - Driving License
- Estonia - Polycarbonate Passport
- Germany - Driver Qualification Card
- Guyana - Driving License
- Kuwait - Paper Passport
- Lebanon - Paper Passport
- Liechtenstein - Driving License
- Malta - Paper Passport
- Malta - Polycarbonate Passport
- Moldova - Driving License
- Netherlands - Alien ID Card
- Oman - Paper Passport
- Peru - Alien ID Card
- Romania - Residence Permit
- UK - Asylum Request
Added support for 28 new versions of already supported documents
- Canada - British Columbia - Public Services Card
- Canada - British Columbia - Driving License
- Cyprus - Residence Permit
- Denmark - Polycarbonate Passport
- Germany - ID Card
- Italy - ID Card
- Ireland - Passport Card
- Malta - ID Card
- Montenegro - ID Card
- Montenegro - Polycarbonate Passport
- North Macedonia - ID Card
- North Macedonia - Polycarbonate Passport
- Norway - Driving License
- Norway - Residence Permit
- Norway - Polycarbonate Passport
- Philippines - Driving License
- Sweden - Polycarbonate Refugee Passport
- Sweden - Social Security Card
- UAE - Resident ID Card
- UK - Proof of Age Card
- USA - Arkansas - ID Card
- USA - Colorado - ID Card
- USA - Idaho - ID Card
- USA - Illinois - ID Card
- USA - New York - Driving License
- USA - New York - ID card
- USA - Pennsylvania - Driving License
- USA - Washington - Driving License
Added support for 3 new versions of already supported documents in BETA
- Denmark - Residence Permit
- Estonia - Residence Permit
- Latvia - Residence Permit
3.1.0
New features
- added support for ARM processors
- new and improved machine learning models for data extraction
- further improved barcode scanning (parsing for non-standard US DLs)
- added anonymization for QR code on Dutch ID card
- anonymization of religion field on Malaysian documents
Added support for 9 new documents:
- Australia - Victoria - Proof of Age Card
- Brazil - Rio de Janeiro - ID Card
- Liechtenstein - ID Card
- Luxembourg - Passport
- Mozambique - ID Card
- Norway - ID Card
- Togo - ID Card
- USA - Wyoming - ID Card
- Zimbabwe - ID Card
Added support for 9 new documents in BETA:
- Barbados - ID Card
- Belgium - Passport
- Brazil - Rio Grande do Sul - ID Card
- Ireland - Residence Permit
- Japan - Residence Permit
- Lithuania - Residence Permit
- Saint Lucia - ID Card
- USA - New Hampshire - ID Card
- USA - South Dakota - ID Card
Added support for 34 new versions of already supported documents:
- Belgium - Resident ID Card
- Canada - Residence Permit
- Estonia - ID Card
- Finland - Alien ID Card
- Finland - ID Card
- Latvia - Alien ID Card
- Lithuania - ID Card
- Luxembourg - ID Card
- Malta - Residence Permit
- Netherlands - ID Card
- Netherlands - Residence Permit
- Poland - ID Card
- Sweden Residence Permit
- USA - Alabama - ID Card
- USA - Alaska - ID Card
- USA - Colorado - Driving License
- USA - Connecticut - ID Card
- USA - District of Colombia - Driving License
- USA - District of Colombia - ID Card
- USA - Iowa - ID Card
- USA - Kansas - ID Card
- USA - Louisiana - Driving License
- USA - Maine - Driving License
- USA - Maine - ID Card
- USA - Minnesota - ID Card
- USA - Mississippi - ID Card
- USA - Nevada - Driving License
- USA - New York - Driving License
- USA - South Carolina - ID Card
- USA - South Dakota - Driving License
- USA - Texas - ID Card
- USA - Vermont - Driving License
- USA - Washington - ID Card
- USA - Wisconsin - Driving License
Added support for 2 new versions of already supported documents in BETA:
- Poland - Residence Permit
- Portugal - Residence Permit
3.0.0
New features
- option to enable extraction of arabic data on certain documents and fields
- option to enable extraction of cyrillic data on certain documents and fields
- barcode performance improvement (new ML model)
- unified DataMatchResult and DataMatchDetailedInfo into a single structure DataMatchResult (removed dataMatchDetailedInfo result member)
- added new result member cardOrientation to ImageAnalysisResult structure
- added new structure AdditionalProcessingInfo
- added new structure StringResult (with Latin, Cyrillic, Arabic members)
- separated DateResult into Date and DateResult
- renamed endpoints:
/blinkidinto/blinkid-single-sideand/blinkid-combinedinto/blinkid-multi-side
Added support for 50 new versions of already supported documents:
- Mexico - Aguascalientes - Driving license
- Mexico - Baja California - Driving license
- Mexico - Hidalgo - Driving license
- USA - Delaware - Driving license
- USA - Florida - ID card
- USA - Hawaii - Driving license
- USA - Kentucky - ID card
- USA - Maryland - ID card
- USA - Michigan - ID card
- USA - Mississippi - Driving license
- USA - Mississippi - ID card
- USA - Missouri - ID card
- USA - Ohio - ID card
- USA - Oklahoma - ID card
- USA - Rhode Island - Driving license
These documents are no longer BETA:
- Australia - New South Wales - ID card
- Australia - South Australia - Proof of Age Card
- Belgium - Minors ID card
- Belgium - Passport
- Canada - Tribal ID card
- Canada - Weapon Permit
- Canada - British Columbia - Minors Public Services Card
- Ireland - Public Services Card
- Israel - ID card
- Ivory Coast - Driving License
- Lebanon - ID card
- Libya - Polycarbonate Passport
- Mexico - Colima - Driving license
- Mexico - Michoacan - Driving license
- Mexico - Tamaulipas - Driving license
- Mexico - Zacatecas - Driving license
- Myanmar - Driving license
- Panama - Temporary Residence Permit
- Slovenia - Residence Permit
- Trinidad and Tobago - Driving license
- USA - Passport
- USA - Maine - ID card
Added support for 2 new ID types in BETA:
Latin America and the Caribbean
- Cuba - ID card
- Cayman Islands - Drivers License
Already supported documents but now with option to enable extraction for new scripts
Arabic - 5 ID types
- Egypt - ID card
- Jordan - ID card
- UAE - ID card
- UAE - Passport
- UAE - Resident ID
Cyrillic - 10 ID types
- Bosnia and Herzegovina - ID card
- Bulgaria - Drivers License
- Bulgaria - ID card
- North Macedonia - Drivers License
- North Macedonia - ID card
- Serbia - ID card
- Ukraine - Drivers License
- Ukraine - ID card
- Ukraine - Residence Permit
- Ukraine - Temporary Residence Permit
2.10.0
New feature:
- ML models with new architecture that result in further 8% decrease in error rate
Support for 8 new document types:
- Northern America
- USA - Polycarbonate Passport
- USA - Nebraska - ID Card
- USA - New York - ID Card
- USA - Utah - ID Card -Latin America and the Caribbean
- Mexico - Polycarbonate Passport
- Brazil - Sao Paolo - ID Card
- Europe
- Austria - Residence Permit
- Asia
- Philippines - ID Card
Back side support added:
- Australia - South Australia - Driving license
Added support for 29 new versions of already supported documents:
- Australia - Northern Territory - Proof of Age Card
- Belgium - Minors ID Card
- Belgium - Residence Permit
- Bolivia - ID Card
- Croatia - Residence Permit
- Cyprus - ID Card
- Czechia - ID card
- Czechia - Residence Permit
- Dominican Republic - Paper Passport
- Greece - Residence Permit
- Italy - Residence Permit
- Ivory Coast - Driving license
- Kuwait - Driving license
- Mexico - Jalisco - Driving license
- Mexico - Nuevo Leon - Driving license
- Peru - ID Card
- Poland - Driving license
- Slovenia - ID Card
- Sweden - ID Card
- Sweden - Polycarbonate Passport
- USA - Georgia - ID Card
- USA - Iowa - ID Card
- USA - Kansas - Driving license
- USA - Maryland - ID Card
- USA - Nebraska - ID Card
- USA - New York - Driving license
- USA - New York - ID Card
- USA - Oklahoma - Driving license
- Vietnam - ID Card
These documents are no longer BETA:
- Finland - Residence Permit
- Guatemala - Driving license
Added support for 2 new ID types in BETA:
- Antigua and Barbuda - Driving license
- Mexico - Professional ID Card
Changes to BlinkID(Combined) Recognizer
- Added new item to enums:
- Region:
- Sao Paulo, when scanning Brazilian Driving licenses
- Region:
- Fixed scanning for Argentina ID - there were confusions for Veteran ID, now we enabled successful extraction on Veteran ID as well
2.9.0
Changes to BlinkID(Combined) Recognizer
- We can now successfully extract data from non-ICAO compliant MRZ fields on the Vietnam Passports when the filler arrow is facing the other way (>) instead of the standard way (<).
Anonymization
- We've added additional anonymization support for:
- Religion field on all supported Malaysian documents (MyKad, MyKas, MyKid, MyPR, MyTentera)
Bugfixes
- Resolved issues with RGB color overlay while extracting document image, which was present on some devices
New feature:
- Added SSL support
- Introduced new docker environment variables: SSL_ENABLED, SSL_KEY_STORE_PATH, SSL_KEY_STORE_PASSWORD, SSL_KEY_STORE_TYPE, SSL_KEY_STORE_PROVIDER, SSL_KEY_PASSWORD and SSL_KEY_ALIAS
2.8.1
Improvements for existing features:
- We've resolved security vulnerabilities
2.8.0
New feature:
- Updated machine learning models resulting in a 41% reduced error rate.
Support for 16 new document types:
- Northern America
- USA - Passport Card
- USA - District of Columbia - ID Card
- USA - Iowa - ID Card
- USA - Tennessee - ID Card
- Latin America and the Caribbean
- Cuba - Paper Passport
- Dominican Republic - Paper Passport
- Panama - Residence Permit (front only)
- Peru - Paper Passport
- Europe
- Cyprus - Paper Passport
- Germany - Minors Passport
- UK - Proof of Age Card (front onyl)
- Ukraine - Residence Permit
- Ukraine - Temporary Residence Permit
- Middle East and Africa
- Qatar - Paper Passport
- UAE - Paper Passport
- Oceania
- Australia - Northern Territory - Proof of Age Card
Back side support added:
- Austria - ID Card
- Australia - South Australia - Driving license
- Australia - Tasmania - Driving license
- Canada - Quebec - Driving license
- Mexico - Quintana Roo Solidaridad - Driving license
- USA - Washington - Driving license
Added support for 26 new versions of already supported documents:
- Afghanistan - ID Card
- Bahrain - ID Card
- Hungary - Residence Permit
- India - ID Card
- Mexico - Tabasco - Driving license
- New Zealand - Driving license (front only)
- The Philippines - Professional ID (front only)
- Slovakia - Residence Permit
- South Africa - ID Card
- Switzerland - Residence Permit
- UK - Driving license
- USA - Colorado - Driving license
- USA - Idaho - Driving license
- USA - Kansas - ID Card
- USA - Kentucky - Driving license
- USA - Maine - Driving license
- USA - Massachusetts - ID Card
- USA - Nebraska - Driving license
- USA - New Hampshire - Driving license
- USA - New Jersey - ID Card
- USA - New Mexico - ID Card
- USA - North Carolina - ID Card
- USA - Utah - Driving license
- USA - Vermont Driving license
- USA - West Virginia - Driving license
These documents are no longer BETA:
- Algeria - Paper Passport
- Slovakia - Residence Permit
- USA - Mississippi - ID Card
Added support for 8 new ID types in BETA:
- Iceland - Paper Passport
- South Africa - ID Card (front only)
- Brazil - Consular Passport (beta)
- Quintana Roo Cozumel - Driving license
- Canada - Social Security Card (front only)
- Canada - British Columbia - Minor Public Services Card
- USA - Maine - ID Card
- USA - North Dakota - ID Card
Changes to BlinkID(Combined) Recognizer
- Added new enums:
- Region:
QUINTANA_ROO_COZUMEL - Type:
CONSULAR_PASSPORT,MINORS_PASSPORT, andMINORS_PUBLIC_SERVICES_CARD
- Region:
2.7.1
Improvements for existing features:
- We've resolved security vulnerabilities
2.7.0
Changes to BlinkID(Combined) Recognizer
- Introduced the expanded DataMatch functionality for the BlinkID with the new result member called
dataMatchDetailedInfo- This result member will enable you to see for which field has been performed, or it did not, the DataMatch functionality. This is enabled for
dateOfBirth,documentNumberanddateOfExpiry. - For example, if the date of expiry is scanned from the front and back side of the document and values do not match, this method will return DataMatchResult: Failed. Result will be DataMatchResult: Success only if scanned values for all fields that are compared are the same. If data matching has not been performed, the result will be DataMatchResult: NotPerformed. This information is available for every of the three mentioned field values above.
- This result member will enable you to see for which field has been performed, or it did not, the DataMatch functionality. This is enabled for
- Fixed issues with scanning Argentina AlienID, where there were confusions with the regular ID.
ClassInfonow correctly returns which ID type is present based on the barcode data.
Changes to BlinkCardRecognizer
- We’ve added support for 1000+ new credit card types.
- Decrease of wrongly PAN field processing by 30% for horizontal credit cards, and by 60% for vertical credit cards.
- Improvements in the Anonymization functionality for Quick Read formats on VISA credit cards, as well as general improvements for all other credit card types.
2.6.2
Improvements for existing features:
- We've resolved security vulnerabilities
2.6.1
Improvements for existing features:
- We've resolved security vulnerabilities
2.6.0.
We've added new documents to our list of supported documents
- Europe
- Austria - ID Card (front only)
- Germany - ID Card
- Latin America and the Caribbean
- Brazil - ID Card (beta)
- Colombia - ID Card (front only)
- Ecuador - ID Card
- Mexico
- Baja California Sur - Driving Licence (beta)
- Ciudad De Mexico - Driving Licence (front only)
- Colima - Driving Licence (front only, beta)
- Michoacan - Driving Licence (beta)
- Nayarit - Driving Licence (beta)
- Quintana Roo Solidaridad - Driving Licence (front only)
- Tlaxcala - Driving Licence
- Veracruz - Driving Licence (beta)
- Oceania
- Australia - Northern Territory (beta)
- Asia
- Japan - My Number Card (front only)
- Singapore - Resident ID
- Northern America
- USA - Missouri - ID Card
- USA - Nevada - Driving Licence
- USA - New York City - ID Card
- USA - Oklahoma - ID Card
Back side support added:
- Mexico - Chiapas - Driving License
No longer BETA:
- Mexico - Baja California - Driving Licence
- Mexico - Chihuahua - Driving Licence
- Mexico - Coahuila - Driving Licence
- Mexico - Guanajuato - Driving Licence
- Mexico - Mexico - Driving Licence
Changes to BlinkID(Combined) Recognizer
- We've added new result members when scanning Australian Driving Licences:
vehicleClass,licenceType,effectiveDateandexpiryDate.- Result member are displayed under the
VehicleClassInfofield; we can also extract data from multiple rows when this vehicle class info data is present on the document (e.g. multiple expiry dates for different vehicle classes).
- Result member are displayed under the
- We've added new enum values:
- Region:
QUINTANA_ROO,QUINTANA_ROO_SOLIDARIDAD,TLAXCALAwhich are available when scanning Mexican Driving Licences. - Type:
MY_NUMBER_CARDwhich is available when scanning Japanese My Number Card documents.
- Region:
- We've added new result member
additionalOptionalAddressInformationwhich gives additional address information about the document owner.- This result member can be present when scanning the Pakistani ID Card for the field
Country of Stay.
- This result member can be present when scanning the Pakistani ID Card for the field
Removed recognizers
- We've removed recognizers:
GermanyDLBack RecognizerandSingaporeChangiEmployeeId Recognizer.
Changes to IDBarcodeRecognizer
- For barcodes in countries: Argentina, Colombia, Nigeria, Panama, and South Africa, we now also extract data from the field
Sexwhen it's populated with the character "X".
Improvements
- We've added support for Brazil ID Card when the cardholder's face image is rotated for 90 degrees on the document.
- We will return face image and document image + data from VIZ part present on the back side.
2.5.1
Bug fixes:
- Fixed issues with barcode recognition
2.5.0
Newly added versions of documents for already supported documents
We’ve added 24 new documents to our list:
- Europe
- Belgium - Driving License (front only)
- Croatia - ID Card
- France - ID Card
- France - Residence Permit (beta)
- Spain - ID Card
- Switzerland - Residence Permit
- UK - Residence Permit
- Oceania
- Australia - Northern Territory - Driving License (front only, beta)
- Middle East and Africa
- UAE - ID Card
- UAE - Resident ID
- Northern America
- Honduras - ID Card (beta)
- USA - Colorado - ID Card
- USA - Minnesota - Driving License
- USA - Nevada - Driving License
- USA - Oklahoma - Driving License
- USA - Wyoming - Driving License
Changes to BlinkID(Combined) Recognizer
- No API changes
Improvements
DataMatchfunctionality is now enabled for single side documents (Passports)- Added a special case to support
DataMatchfor UAE ID Card and Resident ID Card documents for the fieldpersonal_id_number
- Added a special case to support
- We can now extract
additional_personal_id_numberon Ecuador ID Card - Improvements for reading NRIC number on Malaysian documents that have an asterisk (*) character present
- Improved document detection and cropping of the document image
Changes to USDLRecognizer
- No API Changes
- Fixed magneticStripeParser crashing
Changes to IDBarcodeRecognizer
- Added document type ArgentinaAlienID and parser for ArgentinaAlienID2012BarcodeParser
Changes to MRTDRecognizer
- Added support for parsing Dominican Republic ID Card, Senegal ID Card and Ecuador ID Card
- Renamed MRTDDocTypeSmallIDPakistan to MRTDDocTypeSmallIDPakistanConsular
- Bugfixes for parsing:
- Mexico Professional ID
- Croatia Driving License
2.4.0
New feature
- Added proxy support
- Introduced new docker environment variables: PROXY_HOST, PROXY_PORT, TRUST_STORE and TRUST_STORE_PASSWORD
2.3.0
Back side support added:
- Thailand - ID Card
Changes to BlinkID(Combined) Recognizer
- Added new result members -
fathersNameandmothersNameboth in BlinkID and BlinkIDCombined Recognizers, as well as in VIZ result
Improvements
- We can now extract
fathers_nameandmothers_namefrom Mexico Voter ID Card - Australian Driving Licenses for New South Wales, Northern Territory, Queensland, Victoria and Western Australia now have the driver license unique card number field extracted as
document_additional_number
Changes to BarcodeRecognizer
- We’ve removed support for
aztecanddataMatrixbarcode formats from BarcodeRecognizer
Changes to MRTDRecognizer
- Added
MRTD_TYPE_BORDER_CROSSING_CARDto MRTD enum
2.2.2
Improvements for existing features:
- We've resolved security vulnerabilities
2.2.1
Bug fixes:
- We’ve fixed an issue with face and signature image extraction
2.2.0
We’ve added 61 new documents to our supported document list
- Europe
- Austria - Paper Passport
- Belarus - Paper Passport
- Belgium - Paper Passport (beta)
- Bulgaria - Paper Passport
- Estonia - Paper Passport
- France - Paper Passport (beta)
- Georgia - Paper Passport (beta)
- Germany - Paper Passport
- Greece - Paper Passport
- Hungary- Paper Passport
- Italy - Paper Passport (beta)
- Kosovo - Paper Passport
- Moldova - Paper Passport (beta)
- Poland - Paper Passport
- Portugal - Paper Passport
- Spain - Paper Passport
- Switzerland - Paper Passport
- UK - Paper Passport
- Middle East and Africa
- Algeria - Paper Passport (beta)
- Egypt - Paper Passport (beta)
- Eswatini - Paper Passport
- Ghana - Paper Passport
- Iran - Paper Passport (beta)
- Iraq - Paper Passport (beta)
- Israel - Paper Passport (beta)
- Jordan - Paper Passport (beta)
- Kenya - Polycarbonate Passport
- Libya - Polycarbonate Passport (beta)
- Morocco - Paper Passport (beta)
- Nigeria - Paper Passport
- Nigeria - Polycarbonate Passport (beta)
- Qatar - ID Card (front only, beta)
- Saudi Arabia - Paper Passport
- Syria - Paper Passport
- Tanzania - ID Card (beta)
- Tanzania - Voter ID (front only, beta)
- Tunisia - Paper Passport
- Turkey - Paper Passport
- Zimbabwe - Paper Passport
- Latin America and the Caribbean
- Argentina - Paper Passport
- Brazil - Paper Passport (beta)
- Guatemala - Paper Passport
- Haiti - Paper Passport
- Honduras - Paper Passport (beta)
- Mexico - Paper Passport (beta)
- Mexico - Nayarit - Driving Licence (beta)
- Asia
- Bangladesh - Paper Passport
- China - Paper Passport (beta)
- India - Paper Passport
- Indonesia - Paper Passport
- Japan - Paper Passport
- Nepal - Paper Passport
- Pakistan - Paper Passport
- Philippines - Paper Passport
- South Korea - Paper Passport (beta)
- Sri Lanka - Paper Passport
- Uzbekistan - Paper Passport
- Oceania
- Australia - Paper Passport
- Northern America
- Canada - Paper Passport
- Canada - Weapon Permit (front only, beta)
- USA - Paper Passport (beta)
Back side support added:
- Greece - ID Card
- Burkina Faso - ID Card
- Democratic Republic of the Congo - Driving Licence
- Mexico - Veracruz - Driving Licence
- Canada - Citizenship Certificate
No longer BETA:
- Belarus - Driving Licence
- UK - Polycarbonate Passport
- Argentina - Alien ID
- Bahamas - Driving Licence
- Mexico - Durango - Driving Licence
- Venezuela - ID Card
- USA - Kansas - ID Card
Changes to BlinkID(Combined) Recognizer
- We’ve renamed the Swaziland country to Eswatini in results and ClassInfo
- Improved result validation
FieldIdentificationFailedprocessing status is used to indicate if unexpected fields are present on the document. Those fields are then deleted from the result
- We are filling out COUNTRY and REGION fields in ClassInfo, without the field TYPE of document, when using BarcodeID mode for scanning documents where the Front side is not supported, and back side results are extracted from AAMVA compliant barcodes
- This applies only if
ClassInfoisn’t already prepopulated in some other way and when you’re not inFullRecognitionmode
- This applies only if
Changes to BlinkCardRecognizer
- We've added support for reading and extraction of expiry date in MM/YYYY format
Improvements
- We can now extract the date of birth from the document number on the South Korean identity card and from the personal identification number on the driving licence
- Introduced new docker environment variables: LOG_ENABLE_CONSOLE_APPENDER, LOG_ENABLE_FILE_APPENDER and LOG_PATTERN
Anonymization
- We’ve added anonymization support for new documents:
- Document number on Germany paper bio-data page Passport
- Document number on South Korea Identity Card
- Personal identification number on South Korea driving licence
- Personal identification number on South Korea paper bio-data page Passport
2.1.1
Improvements
- Introduced new docker environment variable MAX_REQUEST_SIZE with ability to limit max http request size.
- Minor logging improvements.
2.1.0
We've added 15 new documents to our list of supported documents:
- Europe
- North Macedonia - Polycarbonate Passport -Middle East and Africa
- Botswana - ID Card
- Sudan - Polycarbonate Passport
- Mexico
- Baja California Sur - Driving License (beta)
- Campeche - Driving License (beta)
- Colima - Driving License (beta)
- Oceania
- Australia - Health Insurance Card (front only, beta)
- Asia
- Azerbaijan - Polycarbonate Passport (beta)
- Tajikistan - Polycarbonate Passport (beta)
- Northern America
- Canada - Citizenship Certificate (front only, beta)
- Canada - Ontario - Health Insurance Card (front only)
- Canada - Quebec - Health Insurance Card (front only, beta)
- USA - Military ID Card
- USA - Rhode Island - ID Card
- USA - South Carolina - ID Card
Back side support added:
- Ireland - Passport Card
- Mexico - Puebla - Driving License
- Singapore - S PASS
No longer BETA:
- Finland - Polycarbonate Passport
- Ireland - Passport Card
- Ireland - Polycarbonate Passport
- Kosovo - Driving License
- Latvia - Polycarbonate Alien Passport
- Latvia - Polycarbonate Passport
- Poland - Polycarbonate Passport
- Cameroon - ID Card
- Ghana - ID Card
- Iraq - ID Card
- Tanzania - Driving License
- Turkey - Polycarbonate Passport
- Uganda - Driving License
- Bolivia - Minors ID
- Chile - Driving License
- Ecuador - Driving License
- Haiti - Driving License
- India - Karnataka - Driving License
- India - Maharashtra - Driving License
- Pakistan - Punjab - Driving License
- USA - Global Entry Card
- USA - New Mexico - ID Card
- USA - Wisconsin - ID Card
Changes to BlinkID(Combined) Recognizer
- We've added the parameter
maxAllowedMismatchesPerFieldto settings. When this is set to a non-zero value, DataMatch will be successful as long as the number of mismatched characters doesn't exceed the specified value. - We've added the parameter
allowUncertainFrontSideScanto settings. When this parameter is set to true, the Recognizer will proceed scanning the back side of the document even if the front side scanning resultrecognitionStatusisUNCERTAIN. - We've enabled the return of image and back side data results, even when the
recognitionStatusisUNCERTAIN. Keep in mind that returned images, in this case, might be blurry or low quality.- This applies to all image types: full document image, face and signature image.
- We've added two separate fields for the processing status in the Recognizer Result:
frontProcessingStatusandbackProcessingStatus. They indicate the status of the last recognition process for each side.
Improvements
-
We added support for the Malaysian NRIC numbers that hold an asterisk (*) character.
-
While using
FullRecognitionModefor scanning unsupported Passports, we are now extractingClassInfofrom MRZ -
Improved quality of fully cropped vertical images
-
Better parsing of Bermuda Driving License AAMVA-compliant barcode dates
-
Fix for correct calculation of check digit for Saudi Arabia ID Card MRZ
-
We’ve updated the alpine linux version in docker container to version 3.13
-
We are splitting first and last name from the additional name information (e.g., Nom d’ usage, Epouse, Geb. etc.) into two different results. The additional name info will be a part of the
name_additional_infofield. This applies to the following documents:- France
- ID Card
- Residence Permit
- Germany
- ID Card
- Luxembourg
- ID Card
- Netherlands
- Driving License
- Polycarbonate Passport
- France
-
We are removing title prefixes (e.g., Mrs., Mr., Ing., etc.) from
full_name,first_nameandlast_namefor these documents:- Austria
- Driving License
- ID Card
- Czechia
- Driving License
- Germany
- ID Card
- Thailand
- ID Card
- UK
- Driving License
- Austria
Anonymization
- We've added anonymization for new documents:
- Document number on Germany Polycarbonate Passport
- Document number on Hong Kong Polycarbonate Passport
- Document number and personal ID number on Singapore Polycarbonate Passport
2.0.0
New features and improvements
- New endpoints with statically defined request and responses for all supported recognizers
- Introduced
blink cardandbarcoderecognizers with own endpoints - OpenApi specification in json format for easier integration
- Improved logging
- added
executionIdandtraceIdto all log outputs - available customizations for log levels
- added
- Use of GraalVM-CE for application
- improved startup times
- Parallel image processing for
blink id combinedrecognizer - Ablitiy to expose metrics endpoints
- Ability to enable/disable CORS support
- Automatic CPU architecture detection for better recognition performance
1.36.1
Bug fixes:
- We’ve fixed a casting issue with
ageLimiton/executeendpoint
1.36.0
We've added 15 new documents to our list of supported documents:
- Europe
- North Macedonia - Polycarbonate Passport
- Middle East and Africa
- Botswana - ID Card
- Sudan - Polycarbonate Passport
- Mexico
- Baja California Sur - Driving License (beta)
- Campeche - Driving License (beta)
- Colima - Driving License (beta)
- Oceania
- Australia - Health Insurance Card (front only, beta)
- Asia
- Azerbaijan - Polycarbonate Passport (beta)
- Tajikistan - Polycarbonate Passport (beta)
- Northern America
- Canada - Citizenship Certificate (front only, beta)
- Canada - Ontario - Health Insurance Card (front only)
- Canada - Quebec - Health Insurance Card (front only, beta)
- USA - Military ID Card
- USA - Rhode Island - ID Card
- USA - South Carolina - ID Card
Back side support added:
- Ireland - Passport Card
- Mexico - Puebla - Driving License
- Singapore - S PASS
No longer BETA:
- Finland - Polycarbonate Passport
- Ireland - Passport Card
- Ireland - Polycarbonate Passport
- Kosovo - Driving License
- Latvia - Polycarbonate Alien Passport
- Latvia - Polycarbonate Passport
- Poland - Polycarbonate Passport
- Cameroon - ID Card
- Ghana - ID Card
- Iraq - ID Card
- Tanzania - Driving License
- Turkey - Polycarbonate Passport
- Uganda - Driving License
- Bolivia - Minors ID
- Chile - Driving License
- Ecuador - Driving License
- Haiti - Driving License
- India - Karnataka - Driving License
- India - Maharashtra - Driving License
- Pakistan - Punjab - Driving License
- USA - Global Entry Card
- USA - New Mexico - ID Card
- USA - Wisconsin - ID Card
Changes to BlinkID(Combined) Recognizer
- We've added the parameter
maxAllowedMismatchesPerFieldto settings. When this is set to a non-zero value, DataMatch will be successful as long as the number of mismatched characters doesn't exceed the specified value. - We've added the parameter
allowUncertainFrontSideScanto settings. When this parameter is set to true, the Recognizer will proceed scanning the back side of the document even if the front side scanning resultrecognitionStatusisUNCERTAIN. - We've enabled the return of image and back side data results, even when the
recognitionStatusisUNCERTAIN. Keep in mind that returned images, in this case, might be blurry or low quality.- This applies to all image types: full document image, face and signature image.
- We've added two separate fields for the processing status in the Recognizer Result:
frontProcessingStatusandbackProcessingStatus. They indicate the status of the last recognition process for each side.
Improvements
-
We added support for the Malaysian NRIC numbers that hold an asterisk (*) character.
-
While using
FullRecognitionModefor scanning unsupported Passports, we are now extractingClassInfofrom MRZ -
Improved quality of fully cropped vertical images
-
Better parsing of Bermuda Driving License AAMVA-compliant barcode dates
-
Fix for correct calculation of check digit for Saudi Arabia ID Card MRZ
-
We are splitting first and last name from the additional name information (e.g., Nom d’ usage, Epouse, Geb. etc.) into two different results. The additional name info will be a part of the
name_additional_infofield. This applies to the following documents:- France
- ID Card
- Residence Permit
- Germany
- ID Card
- Luxembourg
- ID Card
- Netherlands
- Driving License
- Polycarbonate Passport
- France
-
We are removing title prefixes (e.g., Mrs., Mr., Ing., etc.) from
full_name,first_nameandlast_namefor these documents:- Austria
- Driving License
- ID Card
- Czechia
- Driving License
- Germany
- ID Card
- Thailand
- ID Card
- UK
- Driving License
- Austria
Anonymization
- We've added anonymization for new documents:
- Document number on Germany Polycarbonate Passport
- Document number on Hong Kong Polycarbonate Passport
- Document number and personal ID number on Singapore Polycarbonate Passport
1.35.1
Bug fixes:
- We've fixed an issue where the readiness probe incorrectly returned not ready as a result of a wrong calculation of request queue size
1.35.0
New documents added to BlinkID(Combined)Recognizer:
- Europe
- Albania - Driver Card (front only)
- Albania - Professional DL (front only)
- Belarus - Driving Licence (front only, beta)
- Belgium - Minors ID (beta)
- Czechia - Residence Permit
- Finland - Alien ID
- Finland - Residence Permit (beta)
- Georgia - Driving Licence (front only)
- Greece - Residence Permit
- Ireland - Passport Card (beta)
- Ireland - Public Services Card (beta)
- Kosovo - Driving Licence (front only, beta)
- Latvia - Alien ID
- Luxembourg - ID Card
- Moldova - ID Card (beta)
- North Macedonia - Driving Licence (front only)
- North Macedonia - ID Card
- Poland - Passport (beta)
- Slovenia - Residence Permit (beta)
- Spain - Alien ID
- UK - Passport (beta)
- MEA
- Algeria - Driving Licence
- Burkina Faso - ID Card (front only)
- Cameroon - ID Card (beta)
- Democratic Republic Of The Congo - Driving Licence (front only, beta)
- Egypt - Driving Licence (beta)
- Ghana - ID Card (beta)
- Iraq - ID Card (beta)
- Ivory Coast - Driving Licence (front only, beta)
- Ivory Coast - ID Card
- Lebanon - ID Card (beta)
- Morocco - Driving Licence
- Mozambique - Driving Licence (front only, beta)
- Oman - Driving Licence (beta)
- Rwanda - ID Card (front only)
- Senegal - ID Card
- Tanzania - Driving Licence (front only, beta)
- Tunisia - Driving Licence (front only)
- Uganda - Driving Licence (front only, beta)
- Latin America & the Caribbean
- Argentina - Alien ID (beta)
- Bahamas - ID Card (front only, beta)
- Bolivia - Minors ID (beta)
- Jamaica - Driving Licence
- Mexico - Residence Permit (beta)
- Mexico - Chiapas - Driving Licence (front only)
- Mexico - Coahuila - Driving Licence (beta)
- Mexico - Durango - Driving Licence (front only, beta)
- Mexico - Guerrero-cocula - Driving Licence (beta)
- Mexico - Guerrero-juchitan - Driving Licence (beta)
- Mexico - Guerrero-tepecoacuilco - Driving Licence (front only, beta)
- Mexico - Guerrero-tlacoapa - Driving Licence (front only, beta)
- Mexico - Hidalgo - Driving Licence
- Mexico - Mexico - Driving Licence (beta)
- Mexico - Morelos - Driving Licence (front only)
- Mexico - Oaxaca - Driving Licence
- Mexico - Puebla - Driving Licence (front only, beta)
- Mexico - San Luis Potosi - Driving Licence (front only)
- Mexico - Sinaloa - Driving Licence (front only, beta)
- Mexico - Sonora - Driving Licence (beta)
- Mexico - Tabasco - Driving Licence (beta)
- Mexico - Yucatan - Driving Licence (beta)
- Mexico - Zacatecas - Driving Licence (beta)
- Panama - Temporary Residence Permit (beta)
- Peru - Minors ID (beta)
- Trinidad And Tobago - Driving Licence (front only, beta)
- Trinidad And Tobago - ID Card
- Oceania
- Australia - South Australia - Proof Of Age Card (front only, beta)
- Asia
- Armenia - ID Card
- Bangladesh - Driving Licence (beta)
- Cambodia - Driving Licence (front only, beta)
- India - Gujarat - Driving Licence (front only, beta)
- India - Karnataka - Driving Licence (front only, beta)
- India - Kerala - Driving Licence (beta)
- India - Madhya Pradesh - Driving Licence (front only, beta)
- India - Maharashtra - Driving Licence (front only, beta)
- India - Punjab - Driving Licence (front only, beta)
- India - Tamil Nadu - Driving Licence (beta)
- Kyrgyzstan - ID Card
- Malaysia - Mypolis (beta)
- Malaysia - Refugee ID (front only)
- Myanmar - Driving Licence (beta)
- Pakistan - Punjab - Driving Licence (front only, beta)
- Sri Lanka - Driving Licence (front only)
- Thailand - Alien ID (front only)
- Thailand - Driving Licence (beta)
- Uzbekistan - Driving Licence (front only, beta)
- Northern America
- Canada - Tribal ID (beta)
- Canada - Nova Scotia - ID Card (beta)
- Canada - Saskatchewan - ID Card (beta)
- USA - Border Crossing Card (front only)
- USA - Global Entry Card (beta)
- USA - Nexus Card (beta)
- USA - Veteran ID (front only)
- USA - Work Permit
- USA - Mississippi - ID Card (beta)
- USA - Montana - ID Card
- USA - New Mexico - ID Card (beta)
- USA - Wisconsin - ID Card (beta)
- Back side support added:
- Hungary - Residence Permit
- Luxembourg - Residence Permit (no longer beta)
- Mauritius - ID Card
- Colombia - Alien ID (no longer beta)
- Mexico - Baja California - Driving Licence
- Mexico - Chihuahua - Driving Licence
- Mexico - Guanajuato - Driving Licence
- Mexico - Michoacan - Driving Licence
- Malaysia - MyKid
- Malaysia - MyPR
- No longer beta:
- Albania - Passport
- Malta - Residence Permit
- Switzerland - Residence Permit
- Bolivia - Driving Licence
- Chile - Passport
- El Salvador - ID Card
- Peru - ID Card
- Singapore - S Pass (front only)
Improvements for existing features
- We've enabled retrieving the face image and cropped document image on all documents with AAMVA-compliant barcodes. This behavior activates the
BADCODE_IDRecognitionMode. You can opt-out of this behavior by settingenableBarcodeIdtofalsein theRecognitionModeFilter.- This enables scanning US driver licenses and IDs on which OCR isn't supported. Use this new recognition mode to extract:
- Face image from the front side
- Barcode data from the back side
- Cropped document images for both sides
- This enables scanning US driver licenses and IDs on which OCR isn't supported. Use this new recognition mode to extract:
- We've improved data extraction through the MRZ:
- We now allow standard M/F values for gender on Mexican documents (along with localized H/M values)
- We're now converting dates to the Gregorian calendar:
- On Taiwan documents with ROC calendar dates
- On Saudi documents with Islamic calendar dates
- We're now filling all date fields when dates are written in a 'partial' form (year only or month-year only):
- Date of issue will be converted to the first day of the (first) month
- E.g. '1999' will be converted to '01.01.1999.'
- E.g. '03.1999.' will be converted to '01.03.1999.'
- Date of expiry will be converted to the last day of the (last) month
- E.g. '1999' will be converted to '31.12.1999.'
- E.g. '03.1999.' will be converted to '31.03.1999.'
- Date of issue will be converted to the first day of the (first) month
Bug fixes:
- We fixed an issue where using
BLINK_IDandBLINK_ID_COMBINEDon the same document resulted in different values for some fields. - We fixed an issue where string type fields sometimes returned
nullinstead of""as a default value - We fixed an issue where date type fields (day, month, year) sometimes returned
nullinstead of0as a default value
1.34.1
Bug fixes:
- We've fixed an issue where the readiness probe incorrectly returned not ready as a result of a wrong calculation of request queue size
1.34.0
###Newly supported identity documents:
- Saudi Arabia - DL (front)
- Saudi Arabia - Resident ID (front)
Changes to the BlinkId(Combined)Recognizer:
- We're now able to extract the additional address on Hungary Address Cards
- We've improved data extraction through the MRZ:
- We now return the document type through
ClassInfo, regardless of theRecognitionModeyou're using (MrzId,MrzPassportorMrzVisa). - This means you can now use
ClassFilterto filter these documents by their type. - We now return the document number on Nigeria IDs complete with its check digit.
- We now support Italy Residence Permits with a CR document code.
- We've extended the
ClassInfostructure with helper methods so you can filter documents by country more easily: - Use
countryName,isoNumericCountryCode,isoAlpha2CountryCodeandisoAlpha3CountryCodeto get the full country names or their representative codes defined by ISO. - We've extended the
BarcodeResultstructure withextendedElements - You can find all data from AAMVA-compliant barcodes under their respective BarcodeElementKey in the BarcodeElements structure
- For a full list of keys please see here
- We've added another
ProcessingStatuscalledAwaitingOtherSide - This status is triggered once BlinkID has finished with the first side of a document and expects the other side, too.
- We're now able to extract the date of birth from the CURP field on Mexico Voter IDs
- We've added a new recognition mode for recognizing still images of documents that have already been cropped:
- Set the
scanCroppedDocumentImageto true when you're feeding BlinkID images of documents that have already been cropped and don't require detection. - Keep in mind that this setting won't work on document images that haven't been properly cropped.
Changes to the IdBarcodeRecognizer:
- We've extended the results with
extendedElements - You can find all data from AAMVA-compliant barcodes under their respective BarcodeElementKey in the BarcodeElements structure
- For a full list of keys please see here
Deprecated recognizers:
- We've deprecated
UsdlRecognizer. Please useIdBarcodeRecognizerinstead.
1.33.2
Improvements for existing features:
We upgraded image to use microblink/java:16 as base image for its security improvements
1.33.1
Improvements for existing features:
We changed the default value for WORKER_TIMEOUT_MS parameter to 30000.
1.33.0
New additions to our supported documents list
-
53 documents added:
- ALBANIA - DL (front)
- BELGIUM - RESIDENCE PERMIT (front, back)
- BOLIVIA - ID (front, back)
- BOSNIA AND HERZEGOVINA - PASSPORT
- CAMBODIA - PASSPORT
- CANADA - RESIDENCE PERMIT (front, back)
- CANADA - MANITOBA - ID (front)
- CANADA - ONTARIO - HEALTH INSURANCE CARD (front)
- CHILE - ALIEN ID (front, back)
- CHINA - ID (front, back)
- COLOMBIA - MINORS ID (front, back)
- CYPRUS - RESIDENCE PERMIT (front, back)
- CZECHIA - PASSPORT
- GREECE - ID (front)
- HAITI - ID (front, back)
- ITALY - RESIDENCE PERMIT (front, back)
- LATVIA - DL (front)
- LATVIA - PASSPORT
- LITHUANIA - PASSPORT
- LUXEMBOURG - DL (front)
- MONTENEGRO - DL (front)
- MONTENEGRO - ID (front, back)
- MONTENEGRO - PASSPORT
- NETHERLANDS - RESIDENCE PERMIT (front, back)
- NICARAGUA - ID (front, back)
- NIGERIA - ID (front, back)
- NORWAY - RESIDENCE PERMIT (front, back)
- OMAN - RESIDENT ID (front, back)
- PARAGUAY - DL (front, back)
- PERU - DL (front, back)
- PHILIPPINES - SOCIAL SECURITY CARD (front)
- ROMANIA - PASSPORT
- RUSSIA - PASSPORT
- SERBIA - PASSPORT
- SLOVAKIA - PASSPORT
- SLOVENIA - PASSPORT
- SOUTH KOREA - DL (front)
- SPAIN - RESIDENCE PERMIT (front, back)
- SWEDEN - RESIDENCE PERMIT (front, back)
- THAILAND - PASSPORT
- UKRAINE - DL (front)
- UKRAINE - PASSPORT
- USA - ARKANSAS - ID (front, back)
- USA - CONNECTICUT - ID (front, back)
- USA - GREEN CARD (front, back)
- USA - MARYLAND - ID (front, back)
- USA - MINNESOTA - ID (front, back)
- USA - NEVADA - ID (front, back)
- USA - NEW YORK CITY - ID (front, back)
- USA - TEXAS - WEAPON PERMIT (front)
- USA - VIRGINIA - ID (front, back)
- VENEZUELA - DL (front)
- VENEZUELA - PASSPORT
-
Beta support added for 46 documents:
- ALBANIA - PASSPORT
- BAHAMAS - DL (front)
- BERMUDA - DL (front)
- BOLIVIA - DL (front)
- CHILE - DL (front)
- COLOMBIA - ALIEN ID (front)
- DENMARK - RESIDENCE PERMIT (front, back)
- DOMINICAN REPUBLIC - DL (front, back)
- ECUADOR - DL (front)
- EL SALVADOR - DL (front, back)
- ESTONIA - RESIDENCE PERMIT (front, back)
- GUATEMALA - DL (front, back)
- HAITI - DL (front)
- HONDURAS - DL (front, back)
- HONDURAS - ID (front, back)
- HUNGARY - ADDRESS CARD (front, back)
- HUNGARY - RESIDENCE PERMIT (front)
- ICELAND - DL (front)
- ISRAEL - ID (front, back)
- JAPAN - DL (front)
- JORDAN - DL (front)
- LATVIA - ALIEN PASSPORT
- LATVIA - RESIDENCE PERMIT (front, back)
- LUXEMBOURG - RESIDENCE PERMIT (front)
- MALTA - RESIDENCE PERMIT (front, back)
- MEXICO - BAJA CALIFORNIA - DL (front)
- MEXICO - CHIHUAHUA - DL (front)
- MEXICO - CIUDAD DE MEXICO - DL (front)
- MEXICO - PROFESSIONAL DL (front)
- MEXICO - GUANAJUATO - DL (front)
- MEXICO - MICHOACAN - DL (front)
- MEXICO - TAMAULIPAS - DL (front, back)
- MEXICO - VERACRUZ - DL (front, back)
- PHILIPPINES - TAX ID (front)
- PHILIPPINES - VOTER ID (front)
- POLAND - RESIDENCE PERMIT (front, back)
- PORTUGAL - RESIDENCE PERMIT (front, back)
- PUERTO RICO - VOTER ID (front)
- SLOVAKIA - RESIDENCE PERMIT (front, back)
- SOUTH KOREA - ID (front)
- SWITZERLAND - RESIDENCE PERMIT (front, back)
- TAIWAN - TEMPORARY RESIDENCE PERMIT (front)
- TURKEY - RESIDENCE PERMIT (front)
- USA - KANSAS - ID (front, back)
- VENEZUELA - ID (front)
- VIETNAM - DL (front)
-
Added back side support for 7 documents:
- ARGENTINA - ID
- ECUADOR - ID
- FINLAND - ID
- NIGERIA - DL
- QATAR - RESIDENCE PERMIT
- URUGUAY - ID
- USA - NEW YORK - DL
-
9 documents are no longer beta:
- BRAZIL - DL
- CANADA - ALBERTA - ID
- MALAYSIA - MyKAS
- MEXICO - NUEVO LEON - DL
- PANAMA - DL
- PORTUGAL - DL
- SAUDI ARABIA - ID
- SRI LANKA - ID
- USA - IDAHO - ID
New features and updates to the BlinkId(Combined)Recognizer
- We’re now able to read partial MRZ formats (2.5 lines), like the ones found on Switzerland and Liechtenstein DLs.
- We’ve added
**documentOptionalAdditionalNumber**to the main part of the result, as well as front and back side VIZ results. - We’ve expanded the set of possible recognizer states with
**StageValid**. This state fixesBlinkIDCombinedRecognizertimeout issues, and enables better control of the Combined scanning pipeline. It activates when the first side of a document has been successfully scanned and scanning of the second side is required.
Fixes
- We’ve fixed an uncommon bug where you’d get incomplete results upon scanning of the MRZ with the
allowUnparsedsetting enabled.
Other features and updates
- We've added ENABLE_LOG_FILE docker variable which is FALSE by default. To enable logging to file, set variable to TRUE.
- We've enabled graceful shutdown, with a grace period of 30 seconds.
- We've introduced WORKER_TIMEOUT_MS docker variable that interrupts recognition after the specifed time period
- We introduced health, livness and readiness endpoints. By default they are located on port 8081 and the port can be switched via HEALTH_PORT docker variable
- /actuator/health/readiness
- /actuator/health/liveness
- /actuator/health/
1.32.1
Bug fixes
We fixed an issue where traceId wasn't shown in logs for BLINK_ID_COMBINED recognizer
Improvements for existing features:
We changed the default value for allowBlurFilter parameter to false. Now blurred documents wont be discarded by default. If you wish to prevent extracting data from such documents set this value to true in your request
1.32.0
New additions to our supported documents list
Plastic page passports
We added support for scanning the visual inspection zone - VIZ includes everything except MRZ or barcode. Keep in mind that BlinkID scans and extracts data only from the VIZ that is on the first plastic page found in the passport list below:
- Chile Passport (BETA)
- Colombia Passport
- Croatia Passport
- Denmark Passport
- Finland Passport (BETA)
- Germany Passport
- Hong Kong Passport (BETA)
- Ireland Passport (BETA)
- Malaysia Passport
- Netherlands Passport
- New Zealand Passport
- Norway Passport
- Singapore Passport
- South Africa Passport
- Sweden Passport
- Turkey Passport (BETA)
Vertical US documents
- California ID
- Illinois ID
- New York ID
- North Carolina ID
- Texas ID
Other documents
- Canada Newfoundland and Labrador DL
- Croatia Residence Permit (BETA)
- Guatemala Consular ID
- Malaysia MyKAS (BETA)
- Mexico Jalisco DL / front side only
- Mexico Nuevo Leon DL (BETA)
- Peru ID (BETA)
- Singapore S Pass (BETA)
- Uruguay ID / front side only
- USA Missouri ID
- USA Texas ID
European DLs with a single line MRZ
BlinkID extracts data from driver’s licenses that contain single line MRZ:
- Croatia DL
- Estonia DL
- France DL
- Ireland DL
- Netherlands DL
- Slovakia DL
Back side supported on:
- Azerbaijan ID
- Singapore DL
- Singapore Employment Pass
No longer BETA
- Slovakia DL
New features and updates in BlinkID(Combined)Recognizer
-
We standardized return values for field
documentTypein amrzDataobject of a response. Values are the following:- UNKNOWN
- IDENTITY_CARD
- PASSPORT
- VISA
- GREEN_CARD
- MALAYSIAN_PASS_IMM13P
- DRIVER_LICENSE
- INTERNATIONAL_TRAVEL_DOCUMENT
-
We changed enum value of
recognitionModefrom MRZ_PHOTO_ID to PHOTO_ID -
We added
signatureImageBase64to the result. Signature image export is controlled byexportSignatureImagein a request body. Extract signature image from the documents below:- Australia Victoria DL
- Austria ID
- Austria DL
- Brunei Military ID
- Colombia ID
- Croatia ID (on 2013 and 2015 versions)
- Cyprus ID
- Czechia ID (on the 2012 version)
- Germany ID (2010 version)
- Germany DL (2013 version)
- Indonesia ID
- Ireland DL
- Italy DL
- Mexico Voter ID
- New Zealand DL
- Slovenia ID
- Spain DL
- Sweden DL
- Switzerland ID
- UAE ID
- UAE Resident ID
-
We enabled extraction of the date of birth from the NRIC from Malaysian documents:
- MyKad
- MyKas
- MyKid
- MyPR
- MyTentera
-
We added anonymization support for:
- MRZ (OPT2 containing the ID number) on China Mainland Travel Permit Hong Kong
- MRZ (Document number) on Germany Alien Passport
- Document number, MRZ (Document number) on Germany ID
- MRZ (Document number) on Germany Minors Passport
- MRZ (Document number) on Germany Passport
- Document number on Hong Kong ID
- MRZ (Document number, OPT1 containing the passport or ID number) on Hong Kong Passport
- Personal ID number on Netherlands DL
- Personal ID number, MRZ (OPT1 containing the BSN) on Netherlands ID
- MRZ (OPT1 containing the BSN) on Netherlands Passport
- Document number on Singapore DL
- Personal ID number on Singapore Employment Pass
- Document number on Singapore FIN Card
- Document number on Singapore ID
- MRZ (Document number, OPT1 containing the NRIC) on Singapore Passport
- Document number on Singapore Resident ID
- Document number on Singapore S Pass
- Personal ID number on Singapore Work Permit
- MRZ (OPT1 containing the resident registration number) on South Korea Diplomatic Passport
- MRZ (OPT1 containing the resident registration number) on South Korea Passport
- MRZ (OPT1 containing the resident registration number) on South Korea Residence Passport
- MRZ (OPT1 containing the resident registration number) on South Korea Service Passport
- MRZ (OPT1 containing the resident registration number) on South Korea Temporary Passport
-
We improved MRZ data extraction on:
- Russia Passport
-
We are deprecating some recognizers, below is the list of deprecated recognizers and recognizers you should use instead
| Deprecated recognizer | New recognizer |
|---|---|
| DOC_FACE | BLINK_ID with photoId right |
| MRTD | BLINK_ID with mrz_id, mrz_visa, mrz_passport rights |
| PASSPORT | BLINK_ID with mrz_passport right |
| VISA | BLINK_ID with mrz_visa right |
| AUT_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| BEL_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| BEL_ID_BACK | BLINK_ID_COMBINED |
| BRN_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| BRN_ID_BACK | BLINK_ID_COMBINED |
| COL_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| CYP_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| CYP_ID_BACK | BLINK_ID_COMBINED |
| CYP_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| HKG_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| INDONESIA_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| IRL_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| ITA_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| KWT_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| KWT_ID_BACK | BLINK_ID_COMBINED |
| MYS_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| IKAD_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| MYKAD_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| MYKAD_BACK | BLINK_ID_COMBINED |
| MYPR_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| MYTENTERA_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| MEX_VOTER_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| NZL_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| NIGERIA_VOTER_ID_BACK | BLINK_ID_COMBINED |
| SGP_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| SGP_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| SGP_ID_BACK | BLINK_ID_COMBINED |
| ESP_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| UAE_DL_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| UAE_ID_FRONT | BLINK_ID or BLINK_ID_COMBINED |
| UAE_ID_BACK | BLINK_ID_COMBINED |
Other features and updates
- We added the field
middleNameto BlinkID(Combined)Recognizer, IDBarcodeRecognizer and USDL Recognizer results. This field is extracted from AAMVA standard compliant barcodes, whenever available. - We added the field
nameSuffixto the USDL recognizer. - Standard output is added as logging output.
Fixes
- We improved the data match logic for Guatemala Consular ID in BlinkID(Combined)Recognizer.
- We fixed an issue that prevented recognition on older generation of CPUs (pre Haswell). To enable recognition to work on older CPUs set docker environment variable WRAPPER_PATH=/wrapper/wrapper.
1.31.1
Bug fixes
- We fixed an issue where a part of the
blinkid-combinedresponse was missing.
1.31.0
Improvements to existing features:
- We have improved parsing of MRZ formats deviating from the ISO/IEC 7501 standard:
- Document discriminator was in place of the document number on driver licenses and IDs from:
- New York
- Michigan
- Canada
- Different check digit calculation for Mexico (Consular) ID
- Recognition of the unofficial
XCTcountry code for Northern Cyprus ID - Recognition of different country codes and check digit calculation on China Mainland Travel Permit for Hong Kong and Macao Residents
- Document discriminator was in place of the document number on driver licenses and IDs from:
- We added anonymization support for:
- MRZ on the Mainland Travel Permit for Hong Kong and Macao Residents
- We have made some changes to the BlinkID(Combined)Recognizer
- You can now see
ProcessingStatusin the results to inspect potential processing errors, such as when barcode detection fails, a mandatory field is missing, etc. - You can now also see a more detailed
ImageAnalysisResultshowing you when:- Face image is detected
- MRZ is detected
- Barcode is detected
- We have added a
RecognitionModeresult member describing which recognition mode was used to produce the results.Noneif no recognition was performed.MrzIdif MRZ recognition was performed on an identity document (but not a passport or a visa).MrzVisaif MRZ recognition was performed on a visa.MrzPassportif MRZ recognition was performed on a passport.PhotoIdif recognition was performed on any unsupported photo ID.FullRecognitionif recognition was performed on any supported document.
- We are now retrieving sex and nationality fields from the MRZ in cases where those two fields cannot be found in the document’s VIZ. Previously, we only used to do this for dates, name fields and document numbers.
- We are now preserving the original string (raw data) of the dates we couldn’t parse.
- Sanitized MRZ fields are returned (removed filler
<)
- You can now see
Minor API Changes
- We have made some changes to the BlinkID(Combined)Recognizer:
- We added additional values to
MrtdDocumentType - We grouped the
conditionsmember from the results with theDriverLicenseDetailedInfostructure- Old
conditionsfield is now deprecated
- Old
- We added additional values to
- We introduced
ENABLE_DEBUGdocker environment variable that enables verbose debug mode- By default
ENABLE_DEBUGis set to false.
- By default
- We introduced
ENABLE_LOG_TRACEdocker environment variable so that users can send atraceIdto enhance request summary log.- By default
ENABLE_LOG_TRACEis set to false.
- By default
As you will probably notice we skipped one version, it's not a mistake. The version 1.30.0 was our internal release.
1.29.0
New features
-
USDL- We added new fields in the scanning results:
street,postalCode,cityandjurisdiction. - We added the
enableCompactParserboolean request parameter- By default it will be set to false
- We added new fields in the scanning results:
-
ID_BARCODE- We added new fields in the scanning results:
street,postalCode,cityandjurisdiction. - We removed the
additionalAddressInformationfield
- We added new fields in the scanning results:
-
BLINK_ID(BLINK_ID_COMBINED)- We added the
additionalPersonalIdNumberfield - We added support for US documents with vertical orientations:
- Alabama DL
- Arizona DL
- California DL
- Colorado DL
- Connecticut DL
- Georgia DL
- Illinois DL
- Iowa DL
- Kansas DL
- Kentucky DL
- Maryland DL
- Massachusetts DL
- Minnesota DL
- Missouri DL
- New Jersey DL
- Ohio DL
- Pennsylvania DL
- South Carolina DL
- Tennessee DL
- Texas DL
- Utah DL
- Washington DL
- Wisconsin DL
- We added the
-
We made changes to the result structure:
- Barcode data is now encapsulated in its own result structure:
BarcodeResult. - Data from all OCR-ed fields, without MRZ data, is now encapsulated in a
VIZResultstructure, representing the "Visual Inspection Zone" data.BLINK_ID_COMBINED: Front side data is available infrontViz, back side data inbackViz, so you can now access data from each side separately.
- The main part of the result, outside these structures, is filled according to these rules:
- Document number is filled with data from MRZ, if present.
- Remaining data is then filled with barcode data.
- Remaining data is filled from back side's visual inspection zone (OCR data outside of MRZ).
- Remaining data is filled from front side's visual inspection zone.
- Remaining data is filled with data from the MRZ.
- Barcode data is now encapsulated in its own result structure:
-
We added result anonymization. With this option enabled, results are not returned for protected fields on documents listed here. The full document image will also have this data blacked out.
- Protected fields are:
- Document number on Hong Kong ID
- MRZ on Hong Kong passports
- Personal ID number on Netherlands DL
- Personal ID number and MRZ on Netherlands ID
- MRZ on Netherlands passports
- Document number on Singapore DL, ID, Fin Card, Resident ID
- Personal ID number on Singapore Employment Pass
- Document number and personal ID number on Singapore Work Permit
- MRZ on Singapore passports.
- You can choose the anonymization mode:
NONE,IMAGE_ONLY,RESULT_FIELDS_ONLY,FULL_RESULT. - FullResult anonymization (both images and data) is set by default.
- Protected fields are:
-
Members
documentImageColorStatusanddocumentImageMoireStatuscan now be found in the result'simageAnalysisResult(frontImageAnalysisResultandbackImageAnalysisResultinBlinkIDCombinedRecognizer).- We added blur detection status to
imageAnalysisResult.
- We added blur detection status to
-
We added support for new identity document types:
- Croatia Health Insurance Card / front side / BETA
- Ecuador ID / front side
- El Salvador ID / BETA
- Sri Lanka ID / BETA
- Back side supported:
- Kenya ID
- No longer BETA:
- Canada Nova Scotia DL
- Canada Yukon DL
- Norway DL
-
We added support for new MRZ formats:
- Guatemala ID
- Kenya ID
####Bug fixes
- We fixed
recognitionStatusForMRTDandUAE_ID_BACKbecause result field was not returned.
1.28.1
Bug fixes
- We fixed the bug that caused some requests to be blocked by the CORS policy
1.28.0
New features
- As of this release, even if the document scan is uncertain or irregular, the results will be retrieved. Meaning that they will contain the data that was possible to read.
- We added
recognitionStatusresult field forBlinkIDRecognizer,BlinkIdCombinedRecognizerandIDBarcodeRecognizerthat indicate if the scan was successful.
- We added
- We introduced
MAX_RECOGNIZERS_PER_REQUESTdocker environment variable that sets a limit for the number of recognizers that can be sent per request- By default
MAX_RECOGNIZERS_PER_REQUESTwill be set to 0, meaning there is no limit. We also added support for removing duplicate recognizers in request.
- By default
1.27.0
Improvements for existing features:
IDBarcodeRecognizer- We added new fields in the scanning results:
restrictions,endorsements, andvehicleClass. - When barcode data parsing fails, the recognizer will now return raw barcode data. The license key controls this functionality.
- We modified the result field
firstNamewhich now contains firstName, middle name and name suffix.
- We added new fields in the scanning results:
BlinkID(Combined)Recognizer- We added support for passport and travel visa scanning.
- For Malaysian MyKad we are now returning if a Moire pattern is present on the scanned document (
NOT_AVAILABLE,NOT_DETECTEDorDETECTED).- Use
documentImageMoireStatusforBLINK_ID. - Use
documentFrontImageMoireStatusanddocumentBackImageMoireStatusforBLINK_ID_COMBINED.
- Use
- We added new recognizer options for field anonymization for specific sensitive data. Enable or disable whether certain sensitive data should be anonymized in full document image result.
- By default
anonymizeImagerequest parameter is set to TRUE to enable image anonymization. Set it to FALSE to disable anonymization.
- By default
- We added support for obtaining full document image for IDs with barcodes.
- We added support for barcode parsing on the following documents:
- Argentina ID
- Colombia ID
- Nigeria Voter ID
- South Africa ID
- We added support for new identity document types:
- Australia New South Wales - ID Card / Front only / BETA
- Brazil - Driver License / BETA
- Brunei - Military ID / BETA
- Brunei - Residence Permit / BETA
- Brunei - Temporary Residence Permit / BETA
- Ghana - Driver License / Front only
- Latvia - ID Card
- Norway - Driving Licence / Front only / BETA
- Oman - ID Card
- Saudi Arabia - ID Card / BETA
- Sweden - Social Security Card / Front only
- USA - Social Security Card / BETA
- Back side supported:
- Malaysia - MyTentera
- No longer BETA:
- Australia Tasmania - Driving Licence
- Canada British Columbia - ID Card
- Germany - Residence Permit
- Morocco - ID Card
- Nigeria - Voter ID
- Singapore - Work Permit
- USA Alaska - ID Card
- USA District Of Columbia - Driver License
- USA Indiana - ID Card
- USA Kentucky - ID Card
- You can find the list of all currently supported documents here.
1.26.0
New features:
- We added the age verification feature:
- Now you can more easily obtain the age of the document owner in years and check whether it is below some age limit.
ageandisBelowAgeLimitfields are added to the result. The fieldagecontains a person's age in years, andisBelowAgeLimitwill return true or false based on your setup in theageLimitrequest parameter.- Age verification is available in
BLINK_ID,BLINK_ID_COMBINED,PASSPORT,ID_BARCODE,USDL,VISA, andMRTDrecognizers.
Improvements for existing features:
-
With the power of machine learning, we significantly improved the scanning of ID barcodes. We implemented the Barcode ML Booster feature, which enables scanning of lower quality barcode images.
-
Now
USDLrecognizer returnsdateOfBirthfield as an object withyear,monthanddayfields instead of the date as a string. -
We added
driverLicenseDetailInfoobject in the result field for driver license document types. -
We added
extractIban,extractOwnerandextractValidThruboolean request parameters forBLINK_CARDto enable/disable extraction of specific fields. -
We added recognition from the string option, either from the barcode or MRZ string for
ID_BARCODE,MRTDandUSDLrecognizers. TheinputStringparameter provides string recognition. -
We added support for new document types in
BLINK_IDandBLINK_ID_COMBINEDrecognizers:- Australia - Australian Capital Territory - Driving Licence / front only
- Australia - Northern Territory - Driving Licence / BETA
- Australia - Tasmania - Driving Licence / front only / BETA
- Canada - Alberta - ID Card / BETA
- Canada - British Columbia - Driver License/Public Services Card (Combined)
- Canada - British Columbia - ID Card / BETA
- Canada - British Columbia - Public Services Card
- Canada - New Brunswick - Driving Licence
- Canada - Nova Scotia - Driving Licence / BETA
- Canada - Yukon - Driving Licence / BETA
- Panama - Driving Licence / front only / BETA
- Panama - ID Card / front only
- Singapore - Work Permit / BETA
- Taiwan - ID Card / front only / BETA
- USA - Alabama - ID Card
- USA - Alaska - ID Card / BETA
- USA - District Of Columbia - Driver License / BETA
- USA - Idaho - ID Card / BETA
- USA - Indiana - ID Card / BETA
- USA - Kentucky - ID Card / BETA
- USA - Massachusetts - ID Card
- USA - Oregon - ID Card
- USA - Washington - ID Card
- Back side supported:
- Australia - Western Australia - Driving Licence
- Mexico - Voter ID
- Netherlands - Driving Licence
- You can find the list of all currently supported documents here.
-
Additional improvements in
BLINK_IDandBLINK_ID_COMBINEDrecognizers:- When the back side of the document is not fully supported by the
BLINK_ID_COMBINED, we will capture and return the back side image. If the back side contains MRZ, we will also try to extract data from it. You can disable this behavior by usingskipUnsupportedBackrequest parameter with valuetrue. - We are now returning color status for the scanned document (
COLOR,BLACK_AND_WHITEorNOT_AVAILABLE) in the result fields:documentImageColorStatusforBLINK_ID.documentFrontImageColorStatusanddocumentBackImageColorStatusforBLINK_ID_COMBINED
- We are now returning the
classInfofield, which holds the following information about the scanned document:country,region, andtypeof the document. - Results from the MRZ section of the document are now available in the
mrzDatafield. - We added a data match feature for the
BLINK_ID_COMBINEDrecognizer that will try to perform the matching of the data on the front and back side of the document. The result of the matching is available in thedataMatchResultfield and can have one of the following values:SUCCESS,FAILED,NOT_PERFORMED.
- When the back side of the document is not fully supported by the
1.25.0
New features
- We added a new recognizer for scanning both sides of identity documents -
BLINK_ID_COMBINED. With this recognizer, you can send images of both the front and back sides of the document and get combined data in the result. You can find the list of the currently supported documents here. There is a more detailed explanation of how to useBLINK_ID_COMBINEDrecognizer in our Postman collection.
1.24.1
Bug fixes
- We fixed the bug that caused an empty result field when multiple recognizer types were specified
1.24.0
New features:
- We added a new recognizer specialized for scanning and parsing barcodes on various identity cards -
ID_BARCODE. Supported document types are:- AAMVA compliant (US DL, Canada DL, etc.)
- Argentina ID
- Panama ID
- Colombia ID
- South Africa ID
- Nigeria Voter ID and driver license
- We added recognition from string for
MRTDandUSDLrecognizers, which can extract data from the string in MRZ format. ThemrzStringparameter provides the MRZ string.
Improvements for existing features:
- We added new result fields, returned by all recognizers which scan MRZ (Machine Readable Zone):
issuerNamenationalityName
- New recognizer options in
BLINK_IDandMRTDrecognizers:allowUnparsedMrzResultsandallowUnverifiedMrzResults. - Improvements in
BLINK_IDrecognizer:- New result field:
dateOfExpiryPermanent - Support for 14 new document types:
South Australia DL,Bosnia and Herzegovina DL,Canada Ontario ID,Costa Rica DL,Denmark DL,Estonia DL,Finland DL,Kenya ID,Lithuania DL,Malaysia MyPR,Malta DL,Mexico Consular ID,Nigeria Voter ID,Philippines Professional ID - Improved support for:
USA Hawaii DL,Colombia DL,Costa Rica ID,France ID,India ID,Kazakhstan ID,Kuwait Resident ID,Israel DL,Kuwait DL,Thailand ID
- New result field:
1.23.0
New Features
- We added
localizedNameproperty in the result forBLINK_IDandHKG_ID_FRONTrecognizers (CCC to Chinese alphabet conversion) - With the new
anonymizeNetherlandsMrzparameter in thePASSPORTrecognizer, you can hide the MRZ section in the extracted image of the Netherlands passport - We added
ibanproperty in the result for theBLINK_CARD_FRONTrecognizer - With the new
anonymizeIbanparameter in theBLINK_CARD_FRONTrecognizer, you can hide the IBAN section in the extracted image
Support for new document types
- We added support for Canada Alberta driver's license (front side) to the
BLINK_IDrecognizer
1.22.0
New features
- We added recognizer
DOC_FACEwhich allows extraction of face image and image of the entire document. This recognizer replaces experimentalFACErecognizer. - recognizer
FACEis deprecated and will be removed in future release. Until then it could be used as an alias forDOC_FACE - We added properties
kelDesa,district,rtandrwin the result forINDONESIA_ID_FRONTrecognizer
1.21.0
Security Updates
- We added the environment variables for configuring which URLs are allowed as
imageURLproperty in the request.IMAGE_URL_HOSTS_ALLOWED- if empty, all hosts are allowed. Default value: empty - allow all.IMAGE_URL_PORTS_ALLOWED- Default value:80,443IMAGE_URL_PROTOCOLS_ALLOWED- Default value:http, https
- We added the environment variable for disabling details in HTTP responses in case of error.
VERBOSE_HTTP_RESPONSE- Default value:true. If set tofalseHTTP response will return only a generic error message with HTTP status 500.
New Features
- We introduced a blur filter property that discards blurred frames and prevents reading the data from such frames. By default, the option is enabled, but it can be disabled by adding property
allowBlurFilterto request with valuefalse. - We added the location of the barcode for barcode result types. The location is available in the
detectionPointsin the property result.
Supported Documents
- We added support for new document types for
BLINK_IDrecognizer.BLINK_IDrecognizer automatically detects the type of identity document. You can find a list of supported documents here - Changes in the already supported documents
- We’ve split the
UAE_IDinto two separate documents:UAE_IDandUAE_RESIDENT_ID - Removed support for
BRUNEI_TEMPORARY_RESIDENCE_PERMIT,LATVIA_ID,SAUDI_ARABIA_ID,KENYA_ID, andTAIWAN_IDdocument rights - Added
MEXICO_VOTER_IDdocument right
- We’ve split the
1.20.1
New features
- added support for new document types for
BLINK_IDrecognizer.BLINK_IDrecognizer autodetects type of the Identity document. You can find a list of supported documents here- If you want to scan both the front and back side of the document you can do that in two separate requests. For example if BLINK_ID recognizer is used for scanning front side of the USA Supported identity documents, use USDL recognizer to scan and extract the information from the PDF417 barcode on the back side of the USA Supported identity document
- added support for image annonimization for
BLINK_CARD_FRONTrecognizer. You can control annonimization with optional API boolean properties: - added support for reading front side of Belgian ID - use
BelgiumIdFrontRecognizer - added support for reading back side of Belgian ID - use
BelgiumIdBackRecognizer - added support for reading all visas with MRZ - use
VisaRecognizer
Improvements for existing features
MRTD- support for documents with non-binary gender specification (symbol X)
1.19.0
New features
- public HTTP health check endpoint available at routes
/hcand/recognize/hc, it will also be publicly available when basic authentication is enabled, basic authentication will protect/versionand/info, but not/hc - every response at route
/recognize/executecontains propertyexecutionIdat HTTP body response root object, this is the request identificator of a type 4 (pseudo randomly generated) UUID
1.18.1
Internal improvements
- better image file type detection for deciding location of the image decompression (
C++orJava) based on the checking file signature prefix of the filebase64as string file's representation- all
base64strings ofJPEGs starts with/9j/andPNGs starts withiVBOR - other file types like
GIFs are still decompressed in the Java withImageIO
- all
1.18.0
New features
- added
BLINK_IDrecognizer for scanning front side of ID cards, recognizer classify and extract data from 87 different classes of United States driver's licenses and IDs- in the upcoming releases, we are planning to add support for more document types from different countries
- added support for reading back side of Nigeria Voter ID - use
NIGERIA_VOTER_ID_BACK - added support for Basic authentication
- by default it is disabled
- to enable set both environment variables
BASIC_AUTH_USERNAMEandBASIC_AUTH_PASSWORD - if both
usernameandpasswordare set (notnull, default value if not defined isnull) then the application will be protected with basic authentication BASIC_AUTH_PASSWORDshould be a BCrypt hash of the plain password which will be used in an authenticated HTTP request
Improvements for existing features
- Malaysia
- added support for MyTentera's 6-digit army number
MYTENTERA_FRONT
- added support for MyTentera's 6-digit army number
- United Arab Emirates ID
- improved scanning of back side
UAE_ID_BACK
- improved scanning of back side
Internal improvements
- faster
JPEGandPNGimages decompression to RAW pixels for compressed images greater than1MB- decompression is moved from Java to native C++ wrapper with a performance boost, waiting time is decreased for around
15%(example:150msless for images with resolution in pixels4608x3456) - other formats and small images will be still decompressed in the Java
- decompression is moved from Java to native C++ wrapper with a performance boost, waiting time is decreased for around
1.17.1
Improvements
- removed the option
USER microblinkfrom theDockerfileto avoid issues with a file permissions during volume mapping, to run the container as non-root user use the option--user=microblinkduring container run, by default container will be run under therootuser
1.17.0
New features
- added support for the reading first side of Malaysian iKad documents -
IKAD_FRONTrecognizer - added support to use
HTTPSprotocol (SSL encryption) without the web proxy (Nginx) directly on the Java (Spring Boot) application
Improvements
- upgrade Spring Boot to v2.1.6 (Spring to v5.1.8)
- the application will be started as non-root user
microblink, this is configured with the DockerUSERdefinition - this Docker image uses new
BASEimagemicroblink/javawhich is custom runtime based on the Alpine Linux and OpenJDK. More details about the new base image and it'sDockerfileread it in repository description at https://hub.docker.com/r/microblink/java/
Notes
- to use the application available at
HTTPSprotocol, configure it withJAVA_OPTSdocker environment variable- Example
JAVA_OPTS=-Dserver.ssl.enabled=true- this will use self-signed SSL certificate and application will not be available at theHTTPprotocol
- Example
- to use the application with the custom SSL certificate at the
HTTPSprotocol, use this more complex configuration. To mount the custom certificate from the host machine to the docker container, use the docker volume!- Example
JAVA_OPTS=-Dserver.ssl.enabled=true -Dserver.ssl.key-store-type=PKCS12 -Dserver.ssl.key-store=/custom/mounted/path/my-custom-keystore.p12 -Dserver.ssl.key-store-password=my-custom-keytore-password -Dserver.ssl.key-alias=custom-key-alias
- Example
Tutorials
- https://www.baeldung.com/spring-boot-https-self-signed-certificate
- https://dzone.com/articles/spring-boot-secured-by-lets-encrypt
- https://stackoverflow.com/questions/30896234/how-set-up-spring-boot-to-run-https-http-ports
- https://medium.com/better-programming/running-a-container-with-a-non-root-user-e35830d1f42a
1.16.1
New features
- added support for limiting incoming connections
- waiting-queue can be limited with environment variable
EXECUTION_QUEUE_CAPACITY, the default value is500, 501st (EXECUTION_QUEUE_CAPACITY+1) waiting for the request will be rejected with HTTP status code 503SERVICE_UNAVAILABLE - executions in progress which will exceed timeout limit will be terminated with the HTTP status code 504
GATEWAY_TIMEOUT, timeout customization with environment variableEXECUTION_TIMEOUT_IN_SECONDS, the default value is60, so by default, if the waiting for a response is more than 60 seconds then OCR task will be terminated
Improvements
- internally refactored OCR engine async task handling with task pool size depends on the available CPUs, only limited number of tasks will be executed in parallel, other will wait in the execution queue until thread from the pool become available, this is the huge improvement with memory consumption and response waiting time
1.15.0
New features
- added support for reading all passports with MRZ - use
PASSPORTrecognizer - introduced on application start and periodical (every 60 seconds) workers health check - visible as DEBUG, ERROR and WARNING logs. When the license key is invalid then it is not possible to start the application and when the license becomes invalid during the runtime then warning logs will describe the summary about the issue.
Improvements for existing features
- added support for reading the commercial code in two rows for Hong Kong ID front documents -
HKG_ID_FRONTrecognizer - added support for Hong Kong ID front documents 2018 version
- improved scanning time of all Malaysian ID front documents -
MYKAD_FRONT,MYKAS_FRONT,MYPR_FRONTandMYTENTERA_FRONTrecognizers
1.14.0
New features
- added ability to limit image upload size, by default any image file will be sent to OCR engine
- created new response status code
FORBIDDEN_RECOGNIZERwhich will be part of response if license key has not all required rights but some recognizer which depends on missing rightdoc is requested
Notes
- to activate upload size limit please set environment variable
MICROBLINK_IMAGE_SIZE_LIMIT_IN_MB=<DOUBLE> - to set limit is recommended because when large files are loaded to the memory they can crash the application due to the out of memory issue
- average smart phone camera has 12MP sensor with JPEG image file size between 2MB and 9MB
- recommended image upload size limit is 10MB which will avoid potential application out of memory issue but with success pass for 99% of incoming requests
MICROBLINK_IMAGE_SIZE_LIMIT_IN_MB=10 - large memory consumption is because of conversion compressed JPEG image to the RAW pixels and that's the reason why images with high resolution consume so much memory
Examples
| Image file size | Image type | Image resolution | Megapixels | Memory consumption |
|---|---|---|---|---|
| 0.8MB | JPEG | 1024x1365 | 1.4 | 127MB |
| 2.9MB | JPEG | 2048x2731 | 5.59 | 182MB |
| 3.3MB | JPEG | 4000x3000 | 12 | 298MB |
| 8.2MB | JPEG | 4096x5461 | 22.4 | 451MB |
| 19.5MB | JPEG | 8192x10923 | 89.5 | 960MB |
| 72MB | JPEG | 16384x21845 | 358 | 3.5GB |
1.13.0
New features
- ability to set application arguments through
APP_PARAMSenvironment variable
Bug fixes
- fixed problem with container crash because out of memory, native wrapper management improved with closing detached child processes
- the bug involved in the previous versions:
1.11.2and1.12.0
1.12.0
New features
- added support for reading front
BRN_MILITARY_ID_FRONTside of Brunei Military ID - added support for reading back
BRN_MILITARY_ID_BACKside of Brunei Military ID
Existing features update
- Please note that we have significantly improved accuracy for MRZ/MRTD scanning because now we switched to the newest OCR technology based on machine learning. To be more precise, we measured and compared existing vs. new MRTD scanning. The new OCR system based on machine learning achieves 99.9% accuracy on the character level, which results with a 50% reduction in the error rate in MRZ extraction.
USDLrecognizer- new fields:
rawDataBase64,rawStringData,uncertain,firstName,lastName,fullName,address,dateOfBirth,dateOfIssue,dateOfExpiry,documentNumber,restrictions,endorsements,vehicleClass - deprecated fields:
documentType,standardVersionNumber,customerFamilyName,customerFirstName,customerFullName,eyeColor,addressStreet,addressCity,addressJurisdictionCode,addressPostalCode,fullAddress,height,heightIn,heightCm,customerMiddleName,hairColor,nameSuffix,AKAFullName,AKAFamilyName,AKAGivenName,AKASuffixName,weightRange,weightPounds,weightKilograms,customerIdNumber,familyNameTruncation,firstNameTruncation,middleNameTruncation,placeOfBirth,addressStreet2,raceEthnicity,namePrefix,countryIdentification,residenceStreetAddress,residenceStreetAddress2,residenceCity,residenceJurisdictionCode,residencePostalCode,residenceFullAddress,under18,under19,under21,socialSecurityNumber,AKASocialSecurityNumber,AKAMiddleName,AKAPrefixName,organDonor,veteran,AKADateOfBirth,issuerIdentificationNumber,documentExpirationDate,jurisdictionVersionNumber,jurisdictionVehicleClass,jurisdictionRestrictionCodes,jurisdictionEndorsementCodes,documentIssueDate,federalCommercialVehicleCodes,issuingJurisdiction,standardVehicleClassification,issuingJurisdictionName,standardEndorsementCode,standardRestrictionCode,jurisdictionVehicleClassificationDescription,jurisdictionEndorsmentCodeDescription,jurisdictionRestrictionCodeDescription,inventoryControlNumber,cardRevisionDate,documentDiscriminator,limitedDurationDocument,auditInformation,complianceType,issueTimestamp,permitExpirationDate,permitIdentifier,permitIssueDate,numberOfDuplicates,HAZMATExpirationDate,medicalIndicator,nonResident,uniqueCustomerId,dataDiscriminator,documentExpirationMonth,documentNonexpiring,securityVersion
- new fields:
API change
USDLrecognizerdateOfBirthis date object{ "day": INT, "month": INT, "year": INT, "originalString": STRING }instead ofSTRINGwhich is now in fieldoriginalString
1.11.2
- improved wrapper process management
- removed usage of temp files and refactored whole OCR process to be executed in memory
1.11.1
- more verbose wrapper logs
1.11.0
-
POST /executecan accept propertyimagePathwhere value can be a local path to the source image. Example:/data/path/to/the/my-id-image.jpg, ifimagePathis set and API is able to read file, then propertiesimageURLandimageBase64will be ignored, ifimagePathis not set or API is not able to read file thanimageURLorimageBase64will be used as source image by default. -
FIX: files
temp-image*.jpgare permanently deleted after all success and error responses
1.10.0
-
POST /executecan accept propertyimageURLwhere value can be public available http path to the source image. Example:https://www.example.com/my-id-image.jpg, ifimageURLis set and API is able download image, then propertyimageBase64will be ignored, ifimageURLis not set or API is not able to download image thanimageBase64will be used as source image by default. -
added support for reading front
AUT_DL_FRONTside of Austrian DL -
added support for reading front
BRN_ID_FRONTand backBRN_ID_BACKside of Brunei ID -
added support for reading front
BRN_RES_PERMIT_FRONTand backBRN_RES_PERMIT_BACKside of Brunei Residence Permit -
added support for reading front
BRN_TEMP_RES_PERMIT_FRONTand backBRN_TEMP_RES_PERMIT_BACKside of Brunei Temporary Residence Permit -
added support for reading front
COL_DL_FRONTside of Colombia DL -
added support for reading front
DEU_DL_FRONTside of German DL -
added support for reading front
ITA_DL_FRONTside of Italy DL -
added support for reading front
MYS_DL_FRONTside of Malaysia DL -
added support for reading back
MYKAD_BACKside of Malaysian MyKad -
added support for reading front
MEX_VOTER_ID_FRONTside of Mexico Voter ID -
added support for reading front
NZL_DL_FRONTside of New Zealand DL -
added support for reading front
SGP_DL_FRONTside of Singapore DL
1.9.0
- Upgraded base Docker image microblink/base to v2.0
- new base image v2.0 is based on Linux Alpine and image size of microblink/api is reduced for 5.35 times from 471MB to 88MB
1.8.0
- added support for reading front
SGP_ID_FRONTand backSGP_ID_BACKside of Singapore ID - added support for reading front side of Malaysian MyTentera
MYTENTERA_FRONT, MyPrMYPR_FRONTand MyKasMYKAS_FRONTdocuments - added support for reading front side of Ireland Driver's license
IRL_DL_FRONT - added support for reading the front side of Hong Kong ID
HKG_ID_FRONT - added support for reading front side of credit cards
BLINK_CARD_FRONT
1.7.1
- fix UK Driver's license export of face image
- redirect wrapper logs to
/opt/microblink-api-ws/logs/wrapper.log
1.7.0
- added support for reading UK Driver's license
UK_DL_FRONT - added support for reading the front side of Indonesia ID
INDONESIA_ID_FRONT - added support for reading front side of Malaysian MyKad
MYKAD_FRONT
1.6.0
- Added support for new Cyprus ID format, new and old formats are now available to read with
CYP_ID_FRONTandCYP_ID_BACKrecognizers.
1.5.0
- Added support to load
LICENSEEandLICENSE_KEYenvironment variables from the Docker secrets.
NOTE: Docker secrets are only available to swarm services, not to standalone containers. Docker Compose template is available on GitHub as docker-compose.swarm.yml. How to start application on the Swarm node please follow this steps.
1.4.1
- Added
expiresOnfield toCYP_ID_BACKrecognizer
1.4.0
- Transformed
rawDataofPDF417recognizer to unsigned 8 byte integer[0,255]
1.3.3
- when environment variable
PORTis set then the application will be bind to this value, otherwise, the application will be exposed to the host at a default port8080
1.3.2
- internal performance improvements
1.3.1
- All logs are available inside of container on path
/opt/microblink-api-ws/logs - Created route
GET /recognize/infowith API details about version and available recognizers
1.3.0
-
Added recognizers:
CRO_ID_FRONT(Croatian identity card front side),CRO_ID_BACK(Croatian identity card back side),UAE_DL_FRONT(United Arab Emirates driving license front side),KWT_ID_FRONT(Kuwait identity card front side),KWT_ID_BACK(Kuwait identity card back side),ESP_DL_FRONT(Spanish driving license front side). -
Added Codes:
HTTP_REQUEST_IS_NOT_VALID,HTTP_ENDPOINT_DOES_NOT_EXISTandNOT_ALLOWED_TO_EXECUTE_THIS_API_ENDPOINT,VERSION,DEFAULTandAUTHORIZATION_HEADER_IS_NOT_FOUND_AND_RESULTS_ARE_MASKED. -
Added optional API boolean properties:
detectGlare,exportMrzImage,exportFaceImage,exportFullDocumentImage,exportSignatureImage, default values arefalse. IfdetectGlare=truethan documents with glare will be ignored, in response objectresultwill benull. WhenexportImages=true(introduced in v1.1.0) then all available images extracted from the document will be returned (NOTE: extracting multiple documents extends API waiting time), for better performances use specificexport*Imageflag.
1.2.0
- Improved response with
codeproperty which describes error message with a string constant. Codes:AUTHORIZATION_HEADER_IS_NOT_FOUND,AUTHORIZATION_HEADER_IS_NOT_VALID,INSUFFICIENT_BALANCE,IDENTITY_IS_ARCHIVED,IMAGE_AS_BASE64_IS_REQUIRED,RECOGNIZER_OR_RECOGNIZERS_IS_REQUIRED,RECOGNIZER_IS_NOT_STRING,RECOGNIZER_IS_NOT_VALID,RECOGNIZER_IS_NOT_STRING,RECOGNIZERS_IS_EMPTY,IMAGE_IS_NOT_VALID_BASE64_STRING,IMAGE_IS_NOT_ABLE_TO_CONVERT_TO_RAW_PIXELS,NOT_ALLOWED_TO_EXECUTE_REQUESTED_RECOGNIZER,API_ROLE_IS_NOT_FOUNDandINVALID_LICENSE_KEY, also withcodepropery is available propertysummarywhich in one sentance describes response.
1.1.0
- Added new recognizers: VIN, SIM, UAE_ID_FRONT, UAE_ID_BACK, CYP_ID_FRONT and CYP_ID_BACK
Improved existing recognizers with the upgrade to new Microblink API and new licensing format.
Added optional
exportImagesboolean property to get all available images from the document. This option is available only for these recognizers: MRTD, CYP_ID_FRONT and CYP_ID_BACK.
1.0.2
- Added validation with detailed API return messages and added validation which protects API from worker stuck state.
1.0.1
- Support for run wrapper when some wrapper's right in the license key is missing. This recognizer is still not able to run but other allowed recognizers can be executed.
1.0.0
- Initial public version with recognizers:
MRTD,USDL,PDF417,CODE128,CODE39,AZTEC,DATA_MATRIX,EAN13,EAN8,ITF,QR,UPCAandUPCE