UAT Test Data

Test Data

The latest test data spreadsheets can be found here: KYC Test Data Records DVS Test Data Note: Contracted customers need to request view access to this file. KYB Test Data Records (Australia)

Data DisclaimerWhile effort has been taken to provide realistic data sets, please don’t infer the structure of data based on this (e.g. don’t design your UI validation based on information available in the spreadsheet).No individual information contained within this spreadsheet and any resemblance to real persons, living or dead, is purely coincidental.

Key Testing Guidelines

Name Matching Rules

Family name matching is the primary identifier in sandbox mode
Matching is case-insensitive
Example: “Smith”, “SMITH”, and “smith” are treated as equivalent

Automatic Pass Feature

To force a successful verification for any test subject:

Set middle_name = "passall"

Special Result Types

The sandbox supports different verification outcomes based on test data markers:

Basic Checks

CLEAR: Clean record
PEP: Politically Exposed Person
SANCTION: Sanctions list match
FRAUD: Fraud indicators present

Advanced Checks

Records marked as SKIP will fetch detailed results from an external test service, providing comprehensive response data.

v2 API Test Data Examples

Never use real customer data in testing environments. Always use the testbed data below. Do not use fictional names like “John Smith” or “Jane Doe” — use the actual testbed names for consistent, reliable results.

The following examples show v2 API request payloads for common test scenarios. These use FrankieOne’s official testbed records (TESTONE, TESTTWO, etc.) which produce predictable results in UAT.

v2 format reminders:

Dates use objects: {"year": "YYYY", "month": "MM", "day": "DD"}
Address fields: locality (not suburb), subdivision (not state), postalCode (not postcode)
Documents nested by category: documents.IDENTITY[...]
Document ID field: primaryIdentifier (not idNumber)

Test Scenario Summary

Test Name	Expected Result	Document Type	Country
JAMES TESTONE	CLEAR (PASS)	Driver’s License + Medicare	AUS
JUDY TESTTWO	CLEAR (PASS)	Driver’s License	AUS
PETER TESTTHREE	CLEAR (PASS)	Driver’s License	AUS
MARY TESTFOUR	CLEAR (PASS)	Driver’s License	AUS
GEOFF TESTSEVEN	CLEAR (PASS)	Medicare	AUS
JENNY TESTEIGHT	FAIL (KYC Not Found)	Driver’s License	AUS
JAMES G TESTELEVEN	PEP match	Passport	AUS
BRUCE TESTNINETEEN	SANCTION match	—	AUS
STACY K TESTTWENTY	PEP + SANCTION	—	AUS
Doug J Jeffries	CLEAR (PASS)	SSN (NATIONAL_ID)	USA
RONALD Testonehundredfour	CLEAR (PASS)	Aadhaar (NATIONAL_ID)	IND
THOMAS Testninetythree	CLEAR (PASS)	National ID	CHN

Australian Scenarios

PASS - JAMES TESTONE (Driver's License)

{
  "individual": {
    "name": {
      "givenName": "JAMES",
      "middleName": "A",
      "familyName": "TESTONE"
    },
    "dateOfBirth": {
      "year": "1950",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "status": "CURRENT",
        "unitNumber": "U 1",
        "streetNumber": "35",
        "streetName": "CONN",
        "streetType": "STREET",
        "locality": "FERNTREE GULLY",
        "subdivision": "VIC",
        "postalCode": "3156",
        "country": "AUS",
        "unstructuredLongForm": "U 1/35 CONN STREET, FERNTREE GULLY, VIC 3156"
      }
    ],
    "documents": {
      "IDENTITY": [
        {
          "type": "DRIVERS_LICENSE",
          "class": "IDENTITY",
          "primaryIdentifier": "283229690",
          "secondaryIdentifier": "P5403241",
          "country": "AUS",
          "subdivision": "VIC"
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Expected Result: CLEAR (PASS)

FAIL (KYC Not Found) - JENNY TESTEIGHT (Driver's License)

{
  "individual": {
    "name": {
      "givenName": "JENNY",
      "familyName": "TESTEIGHT"
    },
    "dateOfBirth": {
      "year": "1957",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "streetNumber": "56",
        "streetName": "VICTORIA",
        "streetType": "STREET",
        "locality": "FINGAL",
        "subdivision": "TAS",
        "postalCode": "7214",
        "country": "AUS",
        "unstructuredLongForm": "56 VICTORIA STREET, FINGAL, TAS 7214"
      }
    ],
    "documents": {
      "IDENTITY": [
        {
          "type": "DRIVERS_LICENSE",
          "class": "IDENTITY",
          "primaryIdentifier": "T56543",
          "secondaryIdentifier": "T03989853",
          "country": "AUS",
          "subdivision": "TAS"
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Expected Result: FAIL - KYC Not Found

PASS - GEOFF TESTSEVEN (Medicare Card)

{
  "individual": {
    "name": {
      "givenName": "GEOFF",
      "middleName": "E",
      "familyName": "TESTSEVEN"
    },
    "dateOfBirth": {
      "year": "1956",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "streetNumber": "31",
        "streetName": "POYNTON",
        "streetType": "STREET",
        "locality": "CEDUNA",
        "subdivision": "SA",
        "postalCode": "5690",
        "country": "AUS"
      }
    ],
    "documents": {
      "IDENTITY": [
        {
          "type": "NATIONAL_HEALTH_ID",
          "class": "IDENTITY",
          "primaryIdentifier": "2515129631",
          "subtype": "G",
          "country": "AUS",
          "subdivision": "SA",
          "expiryDate": {
            "year": "2030",
            "month": "01",
            "day": "01",
            "unstructured": "2030-01-01",
            "type": "GREGORIAN"
          },
          "supplementaryData": {
            "type": "NATIONAL_HEALTH_ID",
            "reference": "3",
            "nameOnCardLine1": "GEOFF E TESTSEVEN",
            "nameOnCardLine2": "null",
            "nameOnCardLine3": "null",
            "nameOnCardLine4": "null",
            "middleNameOnCard": "null"
          }
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Note: Australian Medicare cards require:

primaryIdentifier: Medicare card number (10 digits)
subtype: Card color — G (Green), B (Blue), or Y (Yellow)
supplementaryData.reference: Individual reference number on card (1-9)
supplementaryData.nameOnCardLine1: Name as printed on the card
expiryDate: Must include unstructured (YYYY-MM-DD) and type (“GREGORIAN”)

Expected Result: CLEAR (PASS)

PASS - Australian Passport

{
  "individual": {
    "name": {
      "givenName": "Sarah",
      "familyName": "Johnson"
    },
    "dateOfBirth": {
      "year": "1985",
      "month": "03",
      "day": "20"
    },
    "nationality": "AUS",
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "locality": "Melbourne",
        "subdivision": "VIC",
        "postalCode": "3000",
        "country": "AUS"
      }
    ],
    "documents": {
      "IDENTITY": [
        {
          "type": "PASSPORT",
          "class": "IDENTITY",
          "primaryIdentifier": "N1234567",
          "country": "AUS",
          "expiryDate": {
            "normalized": "2030-01-14",
            "year": "2030",
            "month": "01",
            "day": "14",
            "type": "GREGORIAN"
          }
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Minor (Under 18)

{
  "individual": {
    "name": {
      "givenName": "Oliver",
      "middleName": "J",
      "familyName": "YOUNGTEN"
    },
    "dateOfBirth": {
      "year": "2015",
      "month": "06",
      "day": "15"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "streetNumber": "35",
        "streetName": "Conn",
        "streetType": "Street",
        "locality": "Ferntree Gully",
        "subdivision": "VIC",
        "postalCode": "3156",
        "country": "AUS"
      }
    ],
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Note: Must include UNDER18 consent type. May require guardian information — check with FrankieOne.

AML Screening Scenarios

PEP Match - JAMES G TESTELEVEN

{
  "individual": {
    "name": {
      "givenName": "JAMES",
      "middleName": "G",
      "familyName": "TESTELEVEN"
    },
    "dateOfBirth": {
      "year": "1960",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "streetNumber": "23",
        "streetName": "ISA",
        "streetType": "STREET",
        "locality": "FYSHWICK",
        "subdivision": "ACT",
        "postalCode": "2609",
        "country": "AUS"
      }
    ],
    "documents": {
      "IDENTITY": [
        {
          "type": "PASSPORT",
          "class": "IDENTITY",
          "primaryIdentifier": "E55173628",
          "country": "AUS",
          "expiryDate": {
            "normalized": "2030-01-01",
            "year": "2030",
            "month": "01",
            "day": "01",
            "type": "GREGORIAN"
          }
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Expected Result: PEP match

SANCTION Match - BRUCE TESTNINETEEN

{
  "individual": {
    "name": {
      "givenName": "BRUCE",
      "familyName": "TESTNINETEEN"
    },
    "dateOfBirth": {
      "year": "1968",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "country": "AUS"
      }
    ],
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Expected Result: SANCTION matchNote: This example does not include an identity document. Use a workflow that does not require ID verification, such as AUS-Basic3V-TwoPlus.

Combined PEP + SANCTION - STACY K TESTTWENTY

{
  "individual": {
    "name": {
      "givenName": "STACY",
      "middleName": "K",
      "familyName": "TESTTWENTY"
    },
    "dateOfBirth": {
      "year": "1969",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "country": "AUS"
      }
    ],
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Expected Result: PEP + SANCTION (both flags)Note: This example does not include an identity document. Use a workflow that does not require ID verification, such as AUS-Basic3V-TwoPlus.

Workflows without ID documents: The SANCTION and combined PEP + SANCTION examples above do not include identity documents. When testing without ID documents, use a workflow that does not require ID verification, such as AUS-Basic3V-TwoPlus. If you use a workflow that expects an ID document (e.g., AUS-Basic3V-TwoPlusID or AUS-Basic1V-IDOnly), you will receive a BAD_DATA_ID error.

International Scenarios

Workflow names for international scenarios:

USA: Use USA-Basic1V-OnePlus
Global (India, China, UK, etc.): Use GLB-Basic1V-OnePlus

USA - Social Security Number (SSN)

{
  "individual": {
    "name": {
      "givenName": "Doug",
      "middleName": "J",
      "familyName": "Jeffries"
    },
    "dateOfBirth": {
      "year": "1974",
      "month": "08",
      "day": "08"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "country": "USA"
      }
    ],
    "nationality": "USA",
    "documents": {
      "IDENTITY": [
        {
          "type": "NATIONAL_ID",
          "class": "IDENTITY",
          "primaryIdentifier": "123456789",
          "country": "USA"
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Note:

Use NATIONAL_ID document type for SSN (not TAX_ID)
Format: 9 digits without hyphens (e.g., “123456789”)
Workflow: USA-Basic1V-OnePlus

Expected Result: CLEAR

India - Aadhaar

{
  "individual": {
    "name": {
      "givenName": "RONALD",
      "familyName": "Testonehundredfour"
    },
    "dateOfBirth": {
      "year": "1970",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "country": "IND"
      }
    ],
    "nationality": "IND",
    "documents": {
      "IDENTITY": [
        {
          "type": "NATIONAL_ID",
          "class": "IDENTITY",
          "primaryIdentifier": "304365000000",
          "country": "IND"
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Note:

Use NATIONAL_ID document type
Format: 12 digits without dashes
Workflow: GLB-Basic1V-OnePlus

Expected Result: CLEAR

China - National ID

{
  "individual": {
    "name": {
      "givenName": "THOMAS",
      "familyName": "Testninetythree"
    },
    "dateOfBirth": {
      "year": "1959",
      "month": "01",
      "day": "01"
    },
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "country": "CHN"
      }
    ],
    "nationality": "CHN",
    "documents": {
      "IDENTITY": [
        {
          "type": "NATIONAL_ID",
          "class": "IDENTITY",
          "primaryIdentifier": "ABC-123456789",
          "country": "CHN",
          "givenName": "THOMAS",
          "familyName": "TESTNINETYTHREE",
          "dateOfBirth": "1959-01-01",
          "supplementaryData": {
            "type": "NATIONAL_ID",
            "homeCountryFullName": "张伟明"
          }
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Note:

Use NATIONAL_ID document type
givenName / familyName on the document must be Pinyin in uppercase as shown on the ID card
supplementaryData.homeCountryFullName contains the full name in Chinese characters (simplified or traditional, as on the ID)
homeCountryFullName enables the optional NAME_VALIDATION workflow step (transliteration check between Pinyin and Chinese characters)
primaryIdentifier: 18 digits in production (testbed uses placeholder)
Workflow: GLB-Basic1V-OnePlus

Expected Result: CLEAR

UK - Passport (International Individual)

{
  "individual": {
    "name": {
      "givenName": "Emma",
      "familyName": "Williams"
    },
    "dateOfBirth": {
      "year": "1988",
      "month": "11",
      "day": "05"
    },
    "nationality": "GBR",
    "addresses": [
      {
        "type": "RESIDENTIAL",
        "locality": "London",
        "postalCode": "SW1A 1AA",
        "country": "GBR"
      }
    ],
    "documents": {
      "IDENTITY": [
        {
          "type": "PASSPORT",
          "class": "IDENTITY",
          "country": "GBR",
          "primaryIdentifier": "123456789",
          "expiryDate": {
            "normalized": "2030-01-14",
            "year": "2030",
            "month": "01",
            "day": "14",
            "type": "GREGORIAN"
          }
        }
      ]
    },
    "consents": [
      {
        "type": "GENERAL"
      },
      {
        "type": "DOCS"
      },
      {
        "type": "CREDITHEADER"
      },
      {
        "type": "UNDER18"
      }
    ]
  }
}

Note:

Use correct ISO 3166-1 alpha-3 country codes (GBR, USA, CAN, etc.)
Workflow: GLB-Basic1V-OnePlus

v2 Document Type Reference

Important: Use DRIVERS_LICENSE (American spelling with underscore), not DRIVERS_LICENCE.

Country-Specific Document Requirements

Country	Document Type	Primary ID	Secondary ID	Notes
Australia	`DRIVERS_LICENSE`	License number	Card/document number	Both required
Australia	`NATIONAL_HEALTH_ID`	Medicare number (10 digits)	`supplementaryData.reference` (1-9), `subtype` (G/B/Y), `nameOnCardLine1`	All required
Australia	`PASSPORT`	Passport number	—	Include issue/expiry dates
USA	`NATIONAL_ID`	SSN (9 digits, no dashes)	—	Use for Social Security Number
India	`NATIONAL_ID`	Aadhaar (12 digits)	—	No dashes in testbed
China	`NATIONAL_ID`	18-digit ID number	`supplementaryData.homeCountryFullName` (Chinese characters), Pinyin `givenName`/`familyName` on document	`homeCountryFullName` enables NAME_VALIDATION

Document Examples

Australian Driver’s License:

{
  "type": "DRIVERS_LICENSE",
  "class": "IDENTITY",
  "primaryIdentifier": "283229690",
  "secondaryIdentifier": "P5403241",
  "country": "AUS",
  "subdivision": "VIC"
}

Australian Medicare Card:

{
  "type": "NATIONAL_HEALTH_ID",
  "class": "IDENTITY",
  "primaryIdentifier": "6603984391",
  "subtype": "G",
  "country": "AUS",
  "subdivision": "VIC",
  "expiryDate": {
    "year": "2030",
    "month": "01",
    "day": "01",
    "unstructured": "2030-01-01",
    "type": "GREGORIAN"
  },
  "supplementaryData": {
    "type": "NATIONAL_HEALTH_ID",
    "reference": "1",
    "nameOnCardLine1": "JAMES A TESTONE",
    "nameOnCardLine2": "null",
    "nameOnCardLine3": "null",
    "nameOnCardLine4": "null",
    "middleNameOnCard": "null"
  }
}

USA Social Security Number:

{
  "type": "NATIONAL_ID",
  "class": "IDENTITY",
  "primaryIdentifier": "123456789",
  "country": "USA"
}

Valid Document Types

Document Type	Usage
`DRIVERS_LICENSE`	Driver’s license (American spelling)
`PASSPORT`	Passport
`NATIONAL_ID`	National ID (SSN, Aadhaar, China ID, etc.)
`NATIONAL_HEALTH_ID`	Health card (Australian Medicare)
`TAX_ID`	Tax identification number
`VISA`	Visa
`IMMIGRATION`	Immigration document
`BIRTH_CERT`	Birth certificate
`CITIZENSHIP`	Citizenship certificate
`MARRIAGE_CERT`	Marriage certificate
`UTILITY_BILL`	Utility bill
`BANK_STATEMENT`	Bank statement
`CONCESSION`	Concession card
`PENSION`	Pension card
`MILITARY_ID`	Military ID
`OTHER`	Other document type

Simulating Credit Header Failures

You can simulate credit bureau failures by using specific street names in your test payload.

To force a credit header failure, simply set the street name in the address to one of the following bureau names:

Equifax
Experian

The service will then return a failed credit header response for the specified bureau.

For more advanced testing scenarios and error simulation, check out our guide on API Testing Tips.

Introduction

KYC V2 API

Transaction and Activity Monitoring V2 API

KYB V2 API - Preview

Core V2 API

Test Data

Key Testing Guidelines

Basic Checks

Advanced Checks

v2 API Test Data Examples

Test Scenario Summary

Australian Scenarios

AML Screening Scenarios

International Scenarios

v2 Document Type Reference

Country-Specific Document Requirements

Document Examples

Valid Document Types

Simulating Credit Header Failures

Introduction

KYC V2 API

Transaction and Activity Monitoring V2 API

KYB V2 API - Preview

Core V2 API

​Test Data

​Key Testing Guidelines

Basic Checks

Advanced Checks

​v2 API Test Data Examples

​Test Scenario Summary

​Australian Scenarios

​AML Screening Scenarios

​International Scenarios

​v2 Document Type Reference

​Country-Specific Document Requirements

​Document Examples

​Valid Document Types

​Simulating Credit Header Failures

Test Data

Key Testing Guidelines

v2 API Test Data Examples

Test Scenario Summary

Australian Scenarios

AML Screening Scenarios

International Scenarios

v2 Document Type Reference

Country-Specific Document Requirements

Document Examples

Valid Document Types

Simulating Credit Header Failures