New Zealand Documents | FrankieOne

Supported New Zealand Documents

The FrankieOne KYC v2 API supports the following New Zealand documents:

Document	Code
Birth Certificate	`BIRTH_CERT`
Drivers License	`DRIVERS_LICENSE`
Passport	`PASSPORT`

Birth Certificates

Birth certificates are official documents issued by the government that record the birth of an individual. They include details such as the individual’s name, date of birth, place of birth, and parentage. When submitting a birth certificate for verification, ensure the document is clear, complete, and issued by an official authority. It must include all required details as specified below:

Contact your customer success manager to enable New Zealand Birth Certificate verification for your customer account.

Required Fields

Basic Information

Certificate Details

Field Name	Field	Notes
Country	`country`	Must be set to `NZL`
Date of Birth	`dateOfBirth`	Format must be `YYYY-MM-DD`
Document Type	`type`	Must be `BIRTH_CERT`
Name	`name`	Must match the birth certificate exactly (Given name, Middle name, Family name, and any others)

Example Document Structure

1 {
2   "document": {
3     "class": "IDENTITY", // Document classification (should always be "IDENTITY" for KYC)
4     "primaryIdentifier": "000734130", // Registration Number as shown on the birth certificate
5     "type": "BIRTH_CERT", // Document Type (must be "BIRTH_CERT" for birth certificates)
6     "country": "NZL" // Country of issuance, ISO 3166-1 alpha-3 code for New Zealand
7   }
8 }

Best Practices for New Zealand Birth Certificate Verification

When verifying New Zealand birth certificates, ensure:

All names match the document exactly, including order, spelling, and special characters.
The date of birth uses the correct format (YYYY-MM-DD), and historical date formats are handled appropriately.
All required and supplementary fields are collected, even if optional.
Registration numbers and district names are entered exactly as shown on the certificate.
Any discrepancies between the registered name and current legal name are clearly noted.

Drivers Licenses

New Zealand Drivers Licenses are official documents issued by governments that grant individuals the right to operate a vehicle or engage in other regulated activities. They include personal details such as the individual’s name, date of birth, and license number.

Required Fields

Basic Information

License Details

Field Name	Field	Notes
Country	`country`	Must be set to `NZL`
Date of Birth	`dateOfBirth`	Format must be `YYYY-MM-DD`
Document Type	`type`	Must be `DRIVERS_LICENSE`
Name	`name`	Must match the driver’s license exactly (Given name, Middle name, Family name, and any others)

Example Document Structure

1 {
2   "document": {
3     "class": "IDENTITY", // Document classification (should always be "IDENTITY" for KYC)
4     "expiryDate": {
5       "year": "1990", // Expiry year as shown on the license
6       "month": "03", // Expiry month as shown on the license (two digits)
7       "day": "27", // Expiry day as shown on the license (two digits)
8       "unstructured": "1990-03-27", // Full expiry date in YYYY-MM-DD format
9       "type": "GREGORIAN" // Calendar type (always "GREGORIAN")
10     },
11     "primaryIdentifier": "000734130", // License Number as shown on the driver’s license
12     "secondaryIdentifier": "073", // License Version as shown on the driver’s license (e.g. "073")
13     "type": "DRIVERS_LICENSE", // Document Type (must be "DRIVERS_LICENSE" for NZ driver’s licenses)
14     "country": "NZL" // Country of issuance, ISO 3166-1 alpha-3 code for New Zealand
15   }
16 }

Passports

New Zealand passports are official travel documents issued by the New Zealand government that confirm an individual’s identity and citizenship. They include personal details such as the individual’s name, date of birth, passport number, and expiration date.

Required Fields

Basic Information

Passport Details

Field Name	Field	Notes
Country	`country`	Must be set to `NZL` (ISO 3166-1 alpha-3 code for New Zealand)
Date of Birth	`dateOfBirth`	Must be in `YYYY-MM-DD` format
Document Type	`type`	Must be `PASSPORT`
Name	`name`	Must match the passport exactly, including all given, middle, family, and other names, with correct order and spelling

Example Document Structure

1 {
2   "document": {
3     "class": "IDENTITY", // Document classification (should always be "IDENTITY" for KYC)
4     "expiryDate": {
5       "year": "1990", // Expiry year as shown on the passport
6       "month": "03", // Expiry month as shown on the passport (two digits)
7       "day": "27", // Expiry day as shown on the passport (two digits)
8       "unstructured": "1990-03-27", // Full expiry date in YYYY-MM-DD format
9       "type": "GREGORIAN" // Calendar type (always "GREGORIAN")
10     },
11     "primaryIdentifier": "000734130", // Passport Number as shown on the passport, including all characters
12     "type": "PASSPORT", // Document Type (must be "PASSPORT" for New Zealand passports)
13     "country": "NZL" // Country of issuance, ISO 3166-1 alpha-3 code for New Zealand
14   }
15 }

Key Points for New Zealand Passport Verification

Name Matching: Ensure the name matches the passport exactly, including order, spelling, capitalization, special characters, and diacritics.
Country Code: Always use NZL for New Zealand passports.
Passport Number: Enter the passport number exactly as shown; incorrect or expired numbers will cause verification to fail.
Name Order: For visa holders or passports with non-standard name formats, use the name order and format as printed on the document.