Skip to main content
The FrankieOne KYC v2 API supports some New Zealand documents for identity verification. This guide provides details on how to handle these documents effectively.

​
Supported New Zealand Documents

The FrankieOne KYC v2 API supports the following New Zealand documents:
DocumentCode
Birth CertificateBIRTH_CERT
Drivers LicenseDRIVERS_LICENSE
PassportPASSPORT

​
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

Field NameFieldNotes
CountrycountryMust be set to NZL
Date of BirthdateOfBirthFormat must be YYYY-MM-DD
Document TypetypeMust be BIRTH_CERT
NamenameMust match the birth certificate exactly (Given name, Middle name, Family name, and any others)
Example Document Structure 
{
  "document": {
    "class": "IDENTITY", // Document classification (should always be "IDENTITY" for KYC)
    "primaryIdentifier": "000734130", // Registration Number as shown on the birth certificate
    "type": "BIRTH_CERT", // Document Type (must be "BIRTH_CERT" for birth certificates)
    "country": "NZL" // Country of issuance, ISO 3166-1 alpha-3 code for New Zealand
  }
}
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

Field NameFieldNotes
CountrycountryMust be set to NZL
Date of BirthdateOfBirthFormat must be YYYY-MM-DD
Document TypetypeMust be DRIVERS_LICENSE
NamenameMust match the driver’s license exactly (Given name, Middle name, Family name, and any others)
Example Document Structure 
{
  "document": {
    "class": "IDENTITY", // Document classification (should always be "IDENTITY" for KYC)
    "expiryDate": {
      "year": "1990", // Expiry year as shown on the license
      "month": "03", // Expiry month as shown on the license (two digits)
      "day": "27", // Expiry day as shown on the license (two digits)
      "unstructured": "1990-03-27", // Full expiry date in YYYY-MM-DD format
      "type": "GREGORIAN" // Calendar type (always "GREGORIAN")
    },
    "primaryIdentifier": "000734130", // License Number as shown on the driver’s license
    "secondaryIdentifier": "073", // License Version as shown on the driver’s license (e.g. "073")
    "type": "DRIVERS_LICENSE", // Document Type (must be "DRIVERS_LICENSE" for NZ driver’s licenses)
    "country": "NZL" // Country of issuance, ISO 3166-1 alpha-3 code for New Zealand
  }
}

​
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

Field NameFieldNotes
CountrycountryMust be set to NZL (ISO 3166-1 alpha-3 code for New Zealand)
Date of BirthdateOfBirthMust be in YYYY-MM-DD format
Document TypetypeMust be PASSPORT
NamenameMust match the passport exactly, including all given, middle, family, and other names, with correct order and spelling
Example Document Structure 
{
  "document": {
    "class": "IDENTITY", // Document classification (should always be "IDENTITY" for KYC)
    "expiryDate": {
      "year": "1990", // Expiry year as shown on the passport
      "month": "03", // Expiry month as shown on the passport (two digits)
      "day": "27", // Expiry day as shown on the passport (two digits)
      "unstructured": "1990-03-27", // Full expiry date in YYYY-MM-DD format
      "type": "GREGORIAN" // Calendar type (always "GREGORIAN")
    },
    "primaryIdentifier": "000734130", // Passport Number as shown on the passport, including all characters
    "type": "PASSPORT", // Document Type (must be "PASSPORT" for New Zealand passports)
    "country": "NZL" // Country of issuance, ISO 3166-1 alpha-3 code for New Zealand
  }
}
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.