United States Documents | FrankieOne

Supported United States Documents

The FrankieOne KYC v2 API supports the following United States documents:

Document	Code
National ID	`NATIONAL_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.

Note on National ID in the USA

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

Basic Information

ID Details

Field Name	Field	Notes
Country	`country`	Must be set to `USA`.
Date of Birth	`dateOfBirth`	Required. Format must be `YYYY-MM-DD`.
Document Type	`type`	Must be `NATIONAL_ID`.
Name	`name`	Enter the full legal name as shown on the official document, including all given, middle, and family names.
Email	`email`	Optional. If provided, must be a valid email address in standard format.
Phone Number	`phoneNumber`	Optional. If provided, must be a valid US phone number, including area code.
Address	`address`	Optional. If provided, include street, city, state, and ZIP code as listed on the document.

Example Document Structure

1 {
2   "document": {
3     "class": "IDENTITY", // Document classification type
4     "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7", // Unique document identifier
5     "primaryIdentifier": "000734130", // Social Security Number (SSN) or official ID number
6     "type": "NATIONAL_ID", // Document type code
7     "country": "USA" // Country code
8   }
9 }

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