Passport MRZ

Verifies an individual's machine-readable passport

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Compatible Cases

Icon 1

About the service

IDCheckPassportMRZService is a passport verification service. It checks the validity of the machine readable zone (MRZ), and checks the MRZ against any additional supplied optional parameters.

Product Code: W2-DATA-PASSPORT_MRZ-024

Does this service leave a credit search Footprint? No


Request

The following properties pertain to this service.

Property NameTypeOptional/MandatoryNotes
MRZstringMandatory
PassportNumberstringOptional
CountrystringOptionalValidates against the MRZ's nationality if supplied (does not validate against the Country of Issue).Cannot be "None"
ForeNamestringOptional
SurnamestringOptional
MiddleNamesstringOptional
DayOfBirthintegerOptional
MonthOfBirthintegerOptional
YearOfBirthintegerOptional'yyyy'
GenderstringOptionalMust be "M" or "F" if supplied

After performing the search, the validation result (pass, fail, etc.) will be part of the TransactionInformation returned for the service call.


Example Request

"Data": {
	"MRZ": "MRZ... Data truncated"
}


Response

Example Response

"idCheckPassportMRZResult": {
	"validationErrors": [
	"e.g. MRZ is not 88 characters"
	]
}


Sandbox


Example 1

If the PassportNumber is entered as:

"P< CZESPECIMIN<< VZOR<<<<<<<<<<<<<<<<<<<<<<<<< 99003853< 1CZE1101018M120704611010111<<<<<< 94"

then IDCheckPassportMRZResult will contain an empty, non-null ValidationErrors.The corresponding ServiceTransactions will show the following properties:

{
    "HaltTriggered": "False",
    "ServiceTransactionResult": "Success",
    "ServiceInterpretResult": "Pass",
    "ServiceTransactionResultMessage": "This call was generated using sandbox mode",
    "ValidationResult": "NotApplicable"
}

Example 2

If the PassportNumber is entered as any other 88 character string then IDCheckPassportMRZResult's ValidationErrors will contain the error "Final checksum is invalid".

The corresponding ServiceTransactions will show the following properties:

{
    "HaltTriggered": "False",
    "ServiceTransactionResult": "Success",
    "ServiceInterpretResult": "Inconclusive",
    "ServiceTransactionResultMessage": "This call was generated using sandbox mode",
    "ValidationResult": "NotApplicable"
}


Example 3

If the PassportNumber is entered as any other string, or null then IDCheckPassportMRZResult's ValidationErrors will contain the error "MRZ is not 18 characters".

The corresponding ServiceTransactions will show the following properties:

{
    "HaltTriggered": "False",
    "ServiceTransactionResult": "Success",
    "ServiceInterpretResult": "Inconclusive",
    "ServiceTransactionResultMessage": "This call was generated using sandbox mode",
    "ValidationResult": "NotApplicable"
}

Docs not making sense? Please contact us so we can fix them: [email protected] :)

Query Params
string
enum
required
Defaults to 1.5

API version to use

Allowed:
Body Params
string
required

The bundle of services to call

string

A unique reference for the call

Data
object
required
Options
object

These are optional parameters for some extra fields not covered in the Data object. Use this section to set Sandbox mode as well as to add search filters on alerts.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json