# Mexico

Mexico eKYC verification uses phone and email risk-scoring rather than source-of-truth identity matching. See the [eKYC API Reference](https://developer.incode.com/docs/ekyc-api-reference) for common response semantics.

## Available sources

| Source        | API source string | Description                                                                                             |
| ------------- | ----------------- | ------------------------------------------------------------------------------------------------------- |
| MX CONSUMER 1 | `MX_Consumer_1`   | Returns risk scores for phone and email based on third-party data, and an aggregate overall risk level. |

{/* TODO: Confirm with PM — the existing documentation references both `MX_Consumer_1` (combined phone and email) and `MX_TELCO_1` (phone-only) as source values. Confirm whether these are the same backend source, and clarify how they relate to the Dashboard source "MX CONSUMER 1." */}

## MX CONSUMER 1

MX CONSUMER 1 combines phone and email risk-scoring from third-party providers:

- **Phone** returns a risk score based on account history, prepaid status, account duration, and monthly bill amount.
- **Email** returns a predictive risk score based on historical transaction data and behavior patterns.

The request works with only phone or only email supplied. If both are provided, the response includes both individual scores and an aggregate overall risk level.

{/* TODO: Confirm with PM — the Dashboard UI locks both Email and Phone as required for MX CONSUMER 1, but existing API documentation describes an either/or relationship. Confirm which requirement is accurate for customer-facing documentation. */}

### Request parameters

| Parameter         | Required    | Description                                                               |
| ----------------- | ----------- | ------------------------------------------------------------------------- |
| `source`          | Mandatory   | Must be `MX_Consumer_1`.                                                  |
| `country`         | Mandatory   | Must be `MX`.                                                             |
| `phone`           | Conditional | Phone number in E.164 format. Either `phone` or `email` must be provided. |
| `email`           | Conditional | Email address. Either `phone` or `email` must be provided.                |
| `firstName`       | Optional    | First name of the individual, including middle name if applicable.        |
| `surName`         | Optional    | Last name of the individual.                                              |
| `maternalSurname` | Optional    | Maternal surname.                                                         |

### Response fields

| Field          | Statuses                             | Description                                                |
| -------------- | ------------------------------------ | ---------------------------------------------------------- |
| `phoneLevel`   | `low`, `medium`, `high`, `very_high` | Risk level associated with the submitted phone number.     |
| `phoneCarrier` | String                               | Phone carrier associated with the submitted phone number.  |
| `emailLevel`   | `low`, `medium`, `high`, `very_high` | Risk level associated with the submitted email address.    |
| `overallLevel` | `low`, `medium`, `high`, `very_high` | Aggregate risk level combining the phone and email scores. |

### Sample response

```json
{
    "kyc": [
        { "key": "phoneLevel", "status": "low" },
        { "key": "phoneCarrier", "status": "Verizon" },
        { "key": "emailLevel", "status": "low" },
        { "key": "overallLevel", "status": "low" }
    ]
}
```

<br />