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

# Thai Documents

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

## Supported Thai Documents

The FrankieOne KYC v2 API supports the following Thai documents:

| Document    | Code          |
| :---------- | :------------ |
| National ID | `NATIONAL_ID` |

***

### National ID (บัตรประจำตัวประชาชน)

National ID Cards (บัตรประจำตัวประชาชน) are official identification documents issued by the Thai 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.

**Required Fields**

<Card>
  <Tabs>
    <Tab title="Basic Information">
      | Field Name    | Field         | Notes                                                                                                             |
      | :------------ | :------------ | :---------------------------------------------------------------------------------------------------------------- |
      | Country       | `country`     | Must be set to `THA`                                                                                              |
      | Date of Birth | `dateOfBirth` | Must be in `YYYY-MM-DD` format                                                                                    |
      | Document Type | `type`        | Must be `NATIONAL_ID`                                                                                             |
      | Name          | `name`        | Enter the full name exactly as it appears on the National ID card, including all given, middle, and family names. |
    </Tab>

    <Tab title="ID Details">
      | Field Name     | Field                 | Notes                                                                                        |
      | :------------- | :-------------------- | :------------------------------------------------------------------------------------------- |
      | Thai ID Number | `primaryIdentifier`   | Enter the 13-digit Thai National ID number exactly as shown on the card.                     |
      | Laser Code     | `secondaryIdentifier` | Enter the laser code exactly as shown on the back of the card. This value is case-sensitive. |
    </Tab>
  </Tabs>
</Card>

<AccordionGroup>
  <Accordion title="Thai National ID Number Format">
    Thai National ID numbers are 13 digits long and follow a specific structure:

    * **1st digit:** Registration category
    * **2nd–5th digits:** Province or office code
    * **6th–12th digits:** Personal unique number
    * **13th digit:** Check digit (used for validation)

    **Example:** `1-2345-67890-12-3`
  </Accordion>

  <Accordion title="Laser Code Details">
    The laser code is an alphanumeric identifier printed on the back of the Thai National ID card. It is used as an additional security feature and must be entered exactly as shown, including case sensitivity.

    **Example:** `JT0-1234567-89`
  </Accordion>
</AccordionGroup>

**Example Document Structure**

```json theme={null}
{
  "document": {
    "class": "IDENTITY", // Document class must be 'IDENTITY' for KYC checks
    "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7", // Unique identifier for this document in FrankieOne system
    "primaryIdentifier": "000734130", // 13-digit Thai National ID number (must match the card exactly)
    "secondaryIdentifier": "q12313124", // Laser code from the back of the card (case-sensitive, must match exactly)
    "type": "NATIONAL_ID", // Document type code for Thai National ID
    "country": "THA" // Country code for Thailand (ISO 3166-1 alpha-3)
  }
}
```

<Callout icon="bell" color="#FFCA16" iconType="regular">
  ##### Important Considerations for Thai National ID

  To ensure successful verification, pay attention to these common issues:

  * The **ID number** must be exactly 13 digits and pass the official checksum validation.
  * **Names** must match the ID card exactly, including spelling, order, and spacing. Support Thai characters to prevent transcription errors.
  * The **date of birth** must be in `YYYY-MM-DD` format.
  * The **laser code** must be entered exactly as shown on the back of the card, including case sensitivity.
</Callout>
