> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frankieone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# New Zealand ID Documents

<Info>
  This guide covers the verification requirements for official New Zealand
  identity documents including passports and birth certificates.
</Info>

## New Zealand Drivers Licence

<Card title="Driver License Verification" icon="license">
  Verify New Zealand licenses using the following required fields and format
  specifications.
</Card>

**Required Fields**

<AccordionGroup>
  <Accordion title="Personal Information">
    * **Full Name:** Must match passport exactly
      * Given name(s)
      * Family name(s)
    * **Date of Birth:** Format: `YYYY-MM-DD`
  </Accordion>

  <Accordion title="Document Details">
    * **ID Type:** Must be `DRIVERS_LICENSE`
    * **Country:** Must be `NZL`
    * **License Number:** Provided in `idNumber` field
    * **License version:**
      ```json theme={null}
      {
        "kvpKey": "license_version",
        "kvpValue": "version as shown on licence"
      }
      ```
    * **Expiry Date:** Format: `YYYY-MM-DD`
  </Accordion>
</AccordionGroup>

**Implementation Example**

<CodeGroup>
  ```json Example Driver License Request theme={null}
  {
    "identityDocs": [
      {
        "idType": "DRIVERS_LICENSE",
        "country": "NZL",
        "idNumber": "DL123456",
        "extraData": [
          {
            "kvpKey": "license_version",
            "kvpValue": "version as shown on licence"
          }
        ],
        "idExpiry": "2028-01-31"
      }
    ]
  }
  ```
</CodeGroup>

## New Zealand Passport

<Card title="Passport Verification" icon="passport">
  Verify New Zealand passports using the following required fields and format
  specifications.
</Card>

**Required Fields**

<AccordionGroup>
  <Accordion title="Personal Information">
    * **Full Name:** Must match passport exactly
      * Given name(s)
      * Middle name(s)
      * Family name(s)
    * **Date of Birth:** Format: `YYYY-MM-DD`
  </Accordion>

  <Accordion title="Document Details">
    * **ID Type:** Must be `PASSPORT`
    * **Country:** Must be `NZL`
    * **Passport Number:** Provided in `idNumber` field
    * **Expiry Date:** Format: `YYYY-MM-DD`
  </Accordion>
</AccordionGroup>

**Implementation Example**

<CodeGroup>
  ```json Example Passport Request theme={null}
  {
    "identityDocs": [
      {
        "idType": "PASSPORT",
        "country": "NZL",
        "idNumber": "LN123456",
        "idExpiry": "2028-01-31"
      }
    ]
  }
  ```
</CodeGroup>

## Birth Certificate

<Card title="Birth Certificate Verification" icon="certificate">
  Verify New Zealand birth certificates using these specifications.
</Card>

<Callout icon="bell" color="#FFCA16" iconType="regular">
  Contact your customer success manager to enable New Zealand Birth Certificate
  verification for your account.
</Callout>

**Required Fields**

<AccordionGroup>
  <Accordion title="Personal Information">
    * **Full Name:** Must match certificate exactly
      * Given name(s)
      * Middle name(s)
      * Family name(s)
    * **Date of Birth:** Format: `YYYY-MM-DD`
  </Accordion>

  {" "}

  <Accordion title="Certificate Details">
    * **ID Type:** Must be `BIRTH_CERT`
    * **Country:** Must be `NZL`
    * **Registration Number:** Provided in `idNumber` field
  </Accordion>

  <Accordion title="Additional Information">
    Country of birth must be included in `extraData`:

    ```json theme={null}
    {
      "kvpKey": "country_of_birth",
      "kvpValue": "COUNTRY_NAME"
    }
    ```
  </Accordion>
</AccordionGroup>

**Implementation Example**

<CodeGroup>
  ```json Example Birth Certificate Request theme={null}
  {
    "identityDocs": [
      {
        "idType": "BIRTH_CERT",
        "country": "NZL",
        "idNumber": "BC987654",
        "extraData": [
          {
            "kvpKey": "country_of_birth",
            "kvpValue": "New Zealand"
          }
        ]
      }
    ]
  }
  ```
</CodeGroup>

<Callout icon="star" color="#3DD892" iconType="regular">
  When verifying New Zealand identity documents: 1. Ensure all names match
  exactly as shown on the document 2. Use correct date formats (YYYY-MM-DD) 3.
  Include all required extra data fields 4. Verify document numbers are entered
  correctly
</Callout>