Skip to main content

​
Supported United States Documents

The FrankieOne KYC v1 API supports the following United States documents:
DocumentCode
National IDNATIONAL_ID

​
US National ID Card (SSN)

United States National ID Cards are official identification documents issued by the United States government that confirm an individual’s identity and citizenship. They include personal details such as the individual’s name, date of birth, ID card number, and expiration date.
For the United States, the NATIONAL_ID document type in the FrankieOne KYC v2 API primarily facilitates the verification of a Social Security Number (SSN), as the U.S. does not issue a single, standardized physical ‘National ID Card.’ This type is used when the SSN is provided for identity corroboration.
  • Social Security Number (SSN): While not a physical ID card, the SSN is a unique nine-digit number essential for employment, taxation, and accessing government or financial services.
Required Fields

Field NameFieldNotes
CountrycountryMust be set to USA.
Date of BirthdateOfBirthRequired. Format must be YYYY-MM-DD.
Document TypetypeMust be NATIONAL_ID.
NamenameEnter the full legal name as shown on the official document, including all given, middle, and family names.
EmailemailOptional. If provided, must be a valid email address in standard format.
Phone NumberphoneNumberOptional. If provided, must be a valid US phone number, including area code.
AddressaddressOptional. If provided, include street, city, state, and ZIP code as listed on the document.
Example Document Structure with Entity 
{
  "entity": {
    "addresses": [
      {
      "country": "USA",
      "addressId": "86932629-bdb4-158f-e670-741e89ff78ba",
      "addressType": "RESIDENTIAL",
      "buildingName": "Liberty Towers",
      "careOf": "",
      "endDate": "0001-01-01",
      "longForm": "1234 Main Street, Apt 12B, New York, NY 10001, USA",
      "postalCode": "10001",
      "region": "NEW YORK",
      "startDate": "2023-03-10",
      "state": "NY",
      "streetName": "Main Street",
      "streetNumber": "1234",
      "streetType": "Street",
      "suburb": "Manhattan",
      "town": "New York",
      "unitNumber": "Apt 12B",
      "unstructuredLongForm": ""
      }
    ],
    "dateOfBirth": {
      "dateOfBirth": "1978-11-12",
    },
    "entityType": "INDIVIDUAL",
    "identityDocs": [
      {
        "country": "USA",
        "idType": "NATIONAL_ID",
        "idNumber": "123456789", // Social Security Number (SSN)
      }
    ],
    "name": {
      "familyName": "Smith",
      "displayName": "Jane Cecily Smith",
      "givenName": "Jane",
      "middleName": "Cecily"
    },
  }
}
Important Considerations for National ID
Common validation issues to avoid:
  • Incorrect order or casing of names
  • Missing or improperly formatted date of birth (YYYY-MM-DD)
  • Providing an invalid or incomplete Social Security Number (SSN) or ID number