> ## 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.

# United States Documents

The FrankieOne KYC v2 API supports some United States documents for identity verification. This guide provides details on how to handle these documents effectively.

## 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.

<Info>
  ##### 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.
</Info>

**Required Fields**

<Card>
  <Tabs>
    <Tab title="Basic Information">
      | 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.                 |
    </Tab>

    <Tab title="ID Details">
      | Field Name         | Field               | Notes                                                                                                          |
      | ------------------ | ------------------- | -------------------------------------------------------------------------------------------------------------- |
      | Primary Identifier | `primaryIdentifier` | Enter the full Social Security Number (SSN) or other official ID number exactly as it appears on the document. |
    </Tab>
  </Tabs>
</Card>

**Example Document Structure**

```json theme={null}
{
  "document": {
    "class": "IDENTITY", // Document classification type
    "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7", // Unique document identifier in FrankieOne system
    "primaryIdentifier": "000734130", // Social Security Number (SSN) or official ID number
    "type": "NATIONAL_ID", // Document type code
    "country": "USA" // Country code
  }
}
```

<Callout icon="bell" color="#FFCA16" iconType="regular">
  ##### 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
</Callout>