Passport OCR .NET

The .NET OCR SDK supports the passport API for extracting data from passports.

Using this sample passport below, we are going to illustrate how to extract the data that we want using the OCR SDK.

Quick Start

// Load a file from disk and parse it

string path = "./4a16b1d-passport_pic.jpg";
var prediction = await _mindeeClient
    .LoadDocument(File.OpenRead(Path), System.IO.Path.GetFileName(Path))
    .ParseAsync<PassportV1Prediction>();

// Print a summary of the parsed data
System.Console.WriteLine(prediction.Inference.Prediction.ToString());

Output:

-----Passport data-----
Full name: HENERT PUDARSAN
Given names: HENERT
Surname: PUDARSAN
Country: GBR
ID Number: 707797979
Issuance date: 2012-04-22
Birth date: 1995-05-20
Expiry date: 2017-04-22
MRZ 1: P<GBRPUDARSAN<<HENERT<<<<<<<<<<<<<<<<<<<<<<<
MRZ 2: 7077979792GBR9505209M1704224<<<<<<<<<<<<<<00
MRZ: P<GBRPUDARSAN<<HENERT<<<<<<<<<<<<<<<<<<<<<<<7077979792GBR9505209M1704224<<<<<<<<<<<<<<00
----------------------

Field Objects

Each Field object contains at a minimum the following attributes:

• value (string or number depending on the field type):
  Corresponds to the field value. Can be null if no value was extracted.
• confidence (Float):
  The confidence score of the field prediction.
• bbox (Array< Array< Float > >):
  Contains exactly 4 relative vertices coordinates (points) of a right rectangle containing the field in the document.

Extracted Fields

Depending on the field type specified, additional attributes can be extracted from the Passport object.

Using the above passport example, the following are the basic fields that can be extracted.

• Birth Place
• Country
• Dates (Expiry, Issuance, Birth)
• Gender
• Given Names
• ID Number
• Machine Readable Zone
• Surname

Birth Place

• BirthPlace (Field): Passport owner birthplace.

Country

• Country (Field): Passport country in ISO 3166-1 alpha-3 code format (3 letters code).

Dates

Date fields:

• can contain the raw attribute, which is the textual representation found on the document.
• have a value attribute which is the ISO 8601 representation of the date, regardless of the raw contents.

The following date fields are available:

• ExpiryDate: Passport expiry date.

• IssuanceDate: Passport date of issuance.

• BirthDate: Passport's owner date of birth.

Gender

• Gender (StringField): Passport owner's gender (M / F).

Given Names

• GivenNames (List): List of passport owner's given names.

ID

• IdNumber (StringField): Passport identification number.

Machine Readable Zone

• Mrz1 (StringField): Passport first line of machine-readable zone.

• Mrz2 (StringField): Passport second line of machine-readable zone.

Surname

• Surname (StringField): Passport's owner surname.

 

Questions?
  Join our Slack