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

# Mexican Documents

The FrankieOne KYC v2 API supports Mexican documents for identity verification. This guide outlines the requirements and best practices for handling these documents.

## Supported Mexican Documents

The FrankieOne KYC v2 API currently supports the following Mexican document:

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

***

### Mexican National ID Card (INE/IFE)

The Mexican National ID Card—issued as either INE (Instituto Nacional Electoral) or IFE (Instituto Federal Electoral)—serves as an official identification document and voter ID. It contains key personal information, including the individual's full name, date of birth, unique ID number (CURP), and expiration date.

**Required Fields:**

<Card>
  <Tabs>
    <Tab title="Basic Information">
      | Field Name           | Field                | Notes                                                                            |
      | :------------------- | :------------------- | :------------------------------------------------------------------------------- |
      | Document Type        | `type`               | Must be `NATIONAL_ID` for Mexican National ID cards.                             |
      | Country              | `country`            | Must be `MEX` (Mexico).                                                          |
      | Date of Birth        | `dateOfBirth`        | Format: `YYYY-MM-DD`. Enter exactly as shown on the ID.                          |
      | Paternal Family Name | `paternalFamilyName` | Required for Mexican IDs. Use uppercase and match the spelling on the document.  |
      | Maternal Family Name | `maternalFamilyName` | Required for Mexican IDs. Use uppercase and match the spelling on the document.  |
      | Given Names          | `givenName`          | Include all given names as shown on the ID, preserving order and capitalization. |
    </Tab>

    <Tab title="ID Details">
      | Field Name | Field               | Notes                                                                                |
      | :--------- | :------------------ | :----------------------------------------------------------------------------------- |
      | ID Number  | `primaryIdentifier` | Must be provided in the `primaryIdentifier` field. Enter exactly as shown on the ID. |
    </Tab>
  </Tabs>
</Card>

**Example Document Structure**

```json theme={null}
{
  "document": {
    "class": "IDENTITY", // Document class should be 'IDENTITY' for KYC purposes
    "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7", // Unique identifier for this document in FrankieOne system
    "primaryIdentifier": "000734130", // ID number as shown on the Mexican National ID
    "type": "NATIONAL_ID", // Document type must be 'NATIONAL_ID' for Mexican IDs
    "country": "MEX" // Country code must be 'MEX' for Mexico
  },
  "supplementaryData": {
    "type": "NATIONAL_ID", // Reiterate document type for supplementary data
    "paternalFamilyName": "MENDOZA", // Paternal family name (first surname), uppercase, as on the ID
    "maternalFamilyName": "GARCIA" // Maternal family name (second surname), uppercase, as on the ID
  }
}
```

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

  When processing Mexican National ID cards, ensure the following to avoid common validation errors:

  * **Both paternal and maternal family names are required.** Enter them exactly as shown on the ID, using uppercase letters.
  * **Given names:** Include all given names in the correct order and with proper capitalization.
  * **Date of birth:** Use the exact format `YYYY-MM-DD` as printed on the document.
  * **ID number:** Enter the complete and correct ID number as it appears on the card.
</Callout>

<Info>
  ##### Document Number Verification

  The Mexican National ID may be issued as either:

  * INE (Instituto Nacional Electoral) — the current version
  * IFE (Instituto Federal Electoral) — the previous version

  Both INE and IFE cards are valid for verification. Ensure the document number is entered exactly as it appears on the card, regardless of version.
</Info>