Australian Documents

The FrankieOne KYC v2 API supports a variety of Australian documents for identity verification. This guide provides details on how to handle these documents effectively.

Supported Australian Documents

The FrankieOne KYC v2 API supports the following Australian documents:

Document NameDocument Type
Birth CertificateBIRTH_CERT
Centrelink CardCONCESSION
Citizenship CertificateCITIZENSHIP
Death CertificateDEATH_CERT
Immigration Card (ImmiCard)IMMIGRATION
Drivers LicenseDRIVERS_LICENSE
Marriage CertificateMARRIAGE_CERT
Name Change CertificateNAME_CHANGE
National Health ID (Medicare)NATIONAL_HEALTH_ID
National IDNATIONAL_ID
PassportPASSPORT

Birth Certificates

Birth certificates are official documents issued by the government that record an individual’s birth. 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. All required details, as specified below, must be included:

Required Fields

Field NameFieldNotes
CountrycountryMust be set to AUS
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 Other names)
Tips for Birth Certificate Verification

For best results when processing birth certificates:

  • Provide all available fields, including optional ones
  • Use names and dates exactly as shown on the certificate
  • Pay attention to historical date formats and registration district spelling
  • Note any differences between registered and current legal names
  • Matching requirements may vary by state, territory, or certificate age. Supplying complete and accurate information maximizes verification success.

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Always "IDENTITY" for identity documents
4 "primaryIdentifier": "000734130", // Registration Number as shown on the birth certificate
5 "secondaryIdentifier": "P0001975", // Certificate Number as shown on the birth certificate
6 "type": "BIRTH_CERT", // Document type, must be "BIRTH_CERT" for birth certificates
7 "subdivision": "NSW", // Registration State (e.g., VIC, NSW, ACT, WA, SA, NT, QLD, TAS)
8 "country": "AUS", // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
9 "supplementaryData": { // Additional birth certificate details
10 "type": "BIRTH_CERT", // Supplementary data type, must be "BIRTH_CERT"
11 "registrationDate": "2000", // Registration date (format: "YYYY" or "YYYY-MM-DD" as shown on the certificate)
12 "registrationDistrict": "Sydney", // Registration district (optional, if available on the certificate)
13 "dateOfPrint": "2000-03-24", // Date the certificate was printed (format: "YYYY-MM-DD")
14 "registeredGivenName": "Johnny", // Registered given name(s) as shown on the certificate
15 "registeredOtherNames": "Hugo Boss", // Registered other given name(s), if present
16 "registeredFamilyName": "Danger" // Registered family name as shown on the certificate
17 }
18 }
19}

Centrelink cards are official documents issued by the Australian government that provide access to social security and welfare benefits. These cards contain personal details such as the cardholder’s name, date of birth, and Customer Reference Number (CRN).

Required Fields

Field NameFieldNotes
CountrycountryMust be set to AUS
Date of BirthdateOfBirthFormat must be YYYY-MM-DD
Document TypetypeMust be one of CONCESSION, HEALTH_CONCESSION, or PENSION
NamenameMust match the Centrelink card exactly (Given name, Middle name, Family name, and any others)

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY",
4 "expiryDate": {
5 "year": "1990", // Expiry year of the Centrelink card (YYYY)
6 "month": "03", // Expiry month of the Centrelink card (MM)
7 "day": "27", // Expiry day of the Centrelink card (DD)
8 "unstructured": "27-03-1990", // Expiry date in unstructured format (DD-MM-YYYY)
9 },
10 "primaryIdentifier": "000734130", // Centrelink Customer Reference Number (CRN)
11 "type": "CONCESSION", // Document type: CONCESSION, HEALTH_CONCESSION, or PENSION
12 "country": "AUS" // Country code (ISO 3166-1 alpha-3), must be AUS for Australia
13 }
14}

Citizenship Certificates

Citizenship certificates are official documents issued by the Australian government that confirm an individual’s Australian citizenship. These certificates contain personal details such as the individual’s name, date of birth, and certificate (stock) number.

Required Fields

Field NameFieldNotes
CountrycountryMust be set to AUS
Date of BirthdateOfBirthFormat: YYYY-MM-DD
Document TypetypeMust be CITIZENSHIP
NamenameMust match the certificate exactly (Given name, Middle name, Family name, and Other names)

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Document class, always "IDENTITY" for identity documents
4 "primaryIdentifier": "000734130", // Stock Number as shown on the citizenship certificate
5 "type": "CITIZENSHIP", // Document type, must be "CITIZENSHIP"
6 "country": "AUS", // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
7 "supplementaryData": { // Additional certificate details
8 "type": "CITIZENSHIP", // Supplementary data type, must be "CITIZENSHIP"
9 "acquisitionDate": "2000-01-23", // Date citizenship was acquired, format: YYYY-MM-DD
10 "primaryCountry": "AUS", // Primary country of citizenship, must be "AUS"
11 "secondaryCountry": "NZL" // Optional: Secondary country for dual citizenships (ISO 3166-1 alpha-3)
12 }
13 }
14}

Drivers Licenses

Australian driver licences are official documents issued by Australian state or territory governments, authorizing individuals to operate vehicles. Each licence contains personal details such as the holder’s name, date of birth, licence number, and card number. Requirements and formats may vary by jurisdiction.

Field NameFieldNotes
CountrycountryMust be set to AUS
Date of BirthdateOfBirthFormat: YYYY-MM-DD
Document TypetypeMust be DRIVERS_LICENSE
NamenameMust match the licence exactly (Given name, Middle name, Family name, and Other names)
StateFormatLengthExample
ACTNumericUp to 10123456789
NTNumericUp to 10123456789
QLDNumeric8-912345678
NSWAlphanumeric6-8N49187
SAAlphanumeric6ABC123
TASAlphanumeric6-8A12345
VICNumericUp to 10123456789
WANumeric71234567
StateFormatLengthExample
ACTAlphanumeric10ABC1234567
NTNumeric6-8123456
QLDAlphanumeric10ABC1234567
NSWNumeric101234567890
SAAlphanumeric9ABC123456
TASAlphanumeric9ABC123456
VICAlphanumeric8ABC12345
WAAlphanumeric8-10ABC123456

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Document class, always "IDENTITY" for identity documents
4 "primaryIdentifier": "000734130", // Licence Number as shown on the driver licence
5 "secondaryIdentifier": "P0001975", // Card Number as shown on the driver licence (may be required for some states)
6 "type": "DRIVERS_LICENSE", // Document type, must be "DRIVERS_LICENSE"
7 "subdivision": "VIC", // State or territory of issue (e.g., VIC, NSW, QLD, etc.)
8 "country": "AUS" // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
9 }
10}
Victorian Licence Verification – Card Number Handling (Effective July 1, 2023)

Victorian driver licence card number verification is now subject to special rules:

  • For licences flagged as compromised (e.g., due to the Optus breach), the DVS will verify the current card number.
  • For non-compromised licences, the card number is not checked and may match the licence number.
  • Always collect and submit the card number, as verification requirements may change based on historical or future data breaches.
  • If you are a direct DVS user, you may see an audit log entry: “Successful Match – Card Number hasn’t been checked.”

Sample License Images

Australian Capital Territory Driver Licence sample - front
Australian Capital Territory Driver Licence sample - front
Australian Capital Territory Driver Licence sample - back
Australian Capital Territory Driver Licence sample - back
Northern Territory Driver Licence - post 1 November 2020 sample - front
Northern Territory Driver Licence - post 1 November 2020 sample - front
Northern Territory Driver Licence - post 1 November 2020 sample - back
Northern Territory Driver Licence - post 1 November 2020 sample - back
Queensland Driver Licence – post 12 June 2019 sample - front
Queensland Driver Licence – post 12 June 2019 sample - front
Queensland Driver Licence sample - back
Queensland Driver Licence sample - back
New South Wales Driver Licence sample - front
New South Wales Driver Licence sample - front
New South Wales Driver Licence sample - back
New South Wales Driver Licence sample - back
New South Wales Digital Driver Licence sample
New South Wales Digital Driver Licence sample
South Australia Driver Licence sample - front
South Australia Driver Licence sample - front
South Australia Driver Licence sample - back
South Australia Driver Licence sample - back
Tasmania Driver Licence sample - front
Tasmania Driver Licence sample - front
Tasmania Driver Licence sample - back
Tasmania Driver Licence sample - back
Victoria Driver Licence – post 7 November 2022 sample - front
Victoria Driver Licence – post 7 November 2022 sample - front
Victoria Driver Licence - post 7 November 2022 sample - back
Victoria Driver Licence - post 7 November 2022 sample - back
Western Australia Driver Licence sample - front
Western Australia Driver Licence sample - front
Western Australia Driver Licence sample - back
Western Australia Driver Licence sample - back

Immigration Cards (ImmiCard)

ImmiCards are official identity documents issued by the Australian Department of Home Affairs to eligible non-citizens, including visa holders, refugees, and humanitarian entrants. Each ImmiCard contains the holder’s name, date of birth, and a unique ImmiCard number. ImmiCards are used as evidence of identity and residency status in Australia.

Required Fields

Field NameFieldNotes
CountrycountryMust be set to AUS
Date of BirthdateOfBirthFormat must be YYYY-MM-DD
Document TypetypeMust be IMMIGRATION
NamenameMust match the ImmiCard exactly (Given name, Middle name, Family name, and Other names)

For individuals with a single name, use a hyphen (-) in the givenName field. Example: For “Cher”, use {"givenName": "-", "familyName": "Cher"}.

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Always "IDENTITY" for identity documents
4 "primaryIdentifier": "PRE123456", // ImmiCard Number (must be 3 uppercase letters followed by 6 digits, e.g., "PRE123456")
5 "type": "IMMIGRATION", // Document type, must be "IMMIGRATION" for ImmiCard
6 "country": "AUS" // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
7 }
8}
Common Validation Issues

When submitting ImmiCard documents, ensure:

  • The ImmiCard number is exactly 9 characters: 3 uppercase letters (A–Z) followed by 6 digits (0–9), e.g., PRE123456.
  • Name fields must match the ImmiCard exactly, including case, spelling, and spacing. For individuals with a single name, use a hyphen (-) for the given name (e.g., {"givenName": "-", "familyName": "Cher"}).
  • The date of birth must be in YYYY-MM-DD format.
  • Include all names as shown on the card.
  • Double-check all values for accuracy to avoid verification failures.

Marriage Certificate

Marriage certificates are official documents that record the marriage of two individuals. They include personal details such as the names of the individuals, date of marriage, and the issuing authority.

Best Practices for Marriage Certificate Verification
  • Confirm the certificate format before mapping fields.
  • Use correct ISO date formats for all date fields.
  • Follow state-specific requirements, especially for Victoria.
  • Provide all available optional fields for higher verification accuracy.
  • Ensure names match the certificate exactly, including spelling and order.

Required Fields

Field NameFieldNotes
CountrycountryMust be set to AUS
Date of BirthdateOfBirthFormat: YYYY-MM-DD
Document TypetypeMust be MARRIAGE_CERT
NamenameMust match the certificate exactly (Given name, Middle name, Family name, and any other names)

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Document class, always "IDENTITY" for identity documents
4 "primaryIdentifier": "000734130", // Registration Number as shown on the marriage certificate
5 "secondaryIdentifier": "P0001975", // Certificate Number as shown on the marriage certificate
6 "type": "MARRIAGE_CERT", // Document type, must be "MARRIAGE_CERT" for marriage certificates
7 "country": "AUS", // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
8 "subdivision": "NSW", // Registration State or Territory (e.g., VIC, NSW, ACT, WA, SA, NT, QLD, TAS)
9 "supplementaryData": {
10 "type": "MARRIAGE_CERT", // Supplementary data type, must be "MARRIAGE_CERT"
11 "registrationDate": "2023", // Date the marriage was registered; format: "YYYY" or "YYYY-MM-DD" as shown on the certificate
12 "dateOfPrint": "2023-10-01", // Date the certificate was printed; format: "YYYY-MM-DD"
13 "marriageDate": "2023-10-01", // Date the marriage took place; format: "YYYY-MM-DD"
14 "partner1GivenName": "John", // Given name(s) of Partner 1 as shown on the certificate
15 "partner1FamilyName": "Doe", // Family name of Partner 1 as shown on the certificate
16 "partner1OtherName": "Jonah", // Other name(s) of Partner 1, if present (optional)
17 "partner2GivenName": "Jane", // Given name(s) of Partner 2 as shown on the certificate
18 "partner2FamilyName": "Doe", // Family name of Partner 2 as shown on the certificate
19 "partner2OtherName": "Jonesy" // Other name(s) of Partner 2, if present (optional)
20 }
21 }
22}
Victoria (VIC) State-Specific Requirements

For marriage certificate verification in Victoria:

  • Enter the details from the left-hand column or first row as Name 2, regardless of the order on the certificate.
  • Always refer to the latest DVS specifications for Victoria and other states to ensure correct field mapping.
Marriage Certificate Formats

Australian marriage certificates may use different participant labels depending on the certificate version:

  • Traditional: Bride/Groom
  • Modern: Partner 1/Partner 2 Use the format that matches the certificate you are processing.

Name Change Certificates

Name change certificates are official documents issued by Australian state or territory authorities to record an individual’s legal change of name. These certificates include details such as the person’s previous name(s), new name(s), date of registration, and the issuing authority. Name change certificates are required for official identity verification when an individual has changed their legal name.

Required Fields

Field NameFieldNotes
CountrycountryMust be AUS
Date of BirthdateOfBirthFormat: YYYY-MM-DD
Document TypetypeMust be NAME_CHANGE
NamenameMust match the certificate exactly (Given, Middle, Family, and Other names, if present)

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Always "IDENTITY" for identity documents
4 "primaryIdentifier": "000734130", // Registration Number as shown on the name change certificate
5 "secondaryIdentifier": "P0001975", // Certificate Number as shown on the name change certificate
6 "type": "NAME_CHANGE", // Document type, must be "NAME_CHANGE" for name change certificates
7 "country": "AUS", // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
8 "subdivision": "VIC", // Registration State or Territory (e.g., VIC, NSW, ACT, WA, SA, NT, QLD, TAS)
9 "supplementaryData": {
10 "type": "NAME_CHANGE", // Supplementary data type, must be "NAME_CHANGE"
11 "registrationDate": "2000-01-20", // Date the name change was registered; format: "YYYY-MM-DD" or "YYYY" as shown on the certificate
12 "dateOfPrint": "2000-01-20", // Date the certificate was printed; format: "YYYY-MM-DD"
13 "registeredFamilyName": "Doe", // Registered family name as shown on the certificate (may differ from current legal name)
14 "registeredGivenName": "John", // Registered given name(s) as shown on the certificate
15 "registeredOtherGivenNames": "Chris" // Other registered given names, if present (optional)
16 }
17 }
18}

National Health ID (Medicare)

National Health ID cards, commonly known as Medicare cards, are issued by the Australian government to provide access to healthcare services. They include personal details such as the individual’s name, date of birth, and Medicare number.

Required Fields

Field NameFieldNotes
CountrycountryMust be set to AUS
Date of BirthdateOfBirthMust be in YYYY-MM-DD format
Document TypetypeMust be NATIONAL_HEALTH_ID
NamenameMust match the card exactly (Given name, Middle name, Family name, and any other names present)

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Always "IDENTITY" for identity documents
4 "expiryDate": {
5 "year": "1990", // Expiry year as shown on the Medicare card (YYYY)
6 "month": "03", // Expiry month as shown on the Medicare card (MM)
7 "day": "27", // Expiry day as shown on the Medicare card (DD)
8 "unstructured": "1990-03-27", // Expiry date in unstructured format (YYYY-MM-DD), as printed on the card
9 "type": "GREGORIAN" // Calendar type; use "GREGORIAN" for standard dates
10 },
11 "primaryIdentifier": "000734130", // Medicare card number (usually 10 digits, e.g., "1234567890")
12 "type": "NATIONAL_HEALTH_ID", // Document type, must be "NATIONAL_HEALTH_ID" for Medicare cards
13 "subtype": "G", // Card type: "G" (Green), "B" (Blue), or "Y" (Yellow) as indicated on the card
14 "subdivision": "VIC", // State or territory of issue (e.g., VIC, NSW, QLD, etc.)
15 "country": "AUS", // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
16 "supplementaryData": {
17 "type": "NATIONAL_HEALTH_ID", // Supplementary data type, must be "NATIONAL_HEALTH_ID"
18 "reference": "1", // Individual reference number (usually a single digit at the end of the card number)
19 "nameOnCardLine1": "Johnny", // First line of the name as printed on the card
20 "nameOnCardLine2": "Danger", // Second line of the name as printed on the card (if present)
21 "nameOnCardLine3": "null", // Third line of the name as printed on the card (if present, otherwise "null")
22 "nameOnCardLine4": "null", // Fourth line of the name as printed on the card (if present, otherwise "null")
23 "middleNameOnCard": "null" // Middle name as printed on the card (if present, otherwise "null")
24 }
25 }
26}

Australian Passports

Australian passports are official travel documents issued by the Australian government that certify an individual’s identity and citizenship. Each passport contains key personal information, including the holder’s full name, date of birth, passport number, nationality, and expiration date.

When submitting an Australian passport for verification, ensure that all details are entered exactly as they appear on the passport. This includes correct spelling, capitalization, special characters, and the precise order of names. Accurate data entry is critical for successful verification.

Passport Verification

Verify Australian passports for citizens and permanent residents. Ensure all details match the passport exactly, including name, date of birth, and passport number.

Visa Verification

Verify Australian visas for temporary residents and visitors. Use the passport number associated with the visa and match all personal details as shown on the travel document.

Key Passport Verification Guidelines

Exact Name Matching

  • Enter names exactly as shown on the passport, including capitalization, special characters, spaces, and diacritics.

Country Codes

  • For Australian passports, use AUS.
  • For visas, use the ISO 3166-1 alpha-3 code of the passport’s issuing country.

Document Numbers

  • Always provide the passport number, even for visa verification.
  • Ensure the passport number matches the one associated with the visa.
  • Incorrect or expired passport numbers will cause verification to fail.

Name Order for Visas

  • For visa holders, follow the name order and format as printed on the passport, regardless of local conventions.

Required Fields

Field NameFieldNotes
CountrycountryMust be set to AUS
Date of BirthdateOfBirthFormat: YYYY-MM-DD
Document TypetypeMust be PASSPORT
NamenameEnter the full name exactly as shown on the passport (including all given, middle, family, and other names; match spelling, order, and capitalization)
GendergenderMust be provided in the entity object as M, F, or X

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Always "IDENTITY" for identity documents
4 "primaryIdentifier": "N1234567", // Passport number as shown on the passport (letters and numbers, exact match)
5 "type": "PASSPORT", // Document type, must be "PASSPORT" for Australian passports
6 "country": "AUS" // Country code (ISO 3166-1 alpha-3), must be "AUS" for Australia
7 }
8}