Earlier in our docs is an overview of our Know Your Business here. Now, this page is focused specifically on eKYB Pre-fill in Mexico (MX). eKYB Pre-fill in MX leverages Mexico's source of truth to automatically retrieve and populate business information based on a company's tax ID (RFC), including the business name, entity type, registration status, incorporation date, and contact details — without requiring manual input from the user.

Integration

Direct API Approach

All module configurations and user data can be forwarded directly in the request for performing a KYB Pre-fill lookup. This will override existing configuration and data collected about the user.

KYB Pre-fill request

POST /omni/externalVerification/ekyb-prefill

This endpoint performs a KYB Pre-fill lookup for the business specified, retrieving and returning available business data from the source of truth. All fields below are mandatory.

• plugins: must be ["ekyb-prefill"]: (mandatory) String array. Specifies the pre-fill flow.
• source: must be "MX_KYB_PREFILL": (mandatory) String. Identifies the pre-fill source.
• country: (mandatory) String. Two-letter Alpha-2 country code. Must be MX.
• taxId: (mandatory) String. Mexican RFC number. Accepted formats: 13 characters (4 letters + 6 digits + 3 alphanumeric characters) for legal entities, or 12 characters (3 letters + 6 digits + 3 alphanumeric characters) for individuals.

{
    "plugins": ["ekyb-prefill"],
    "source": "MX_KYB_PREFILL",
    "country": "MX",
    "taxId": "ABCD123456789"
}

Response

The KYB Pre-fill response returns business data retrieved directly from the source of truth. Fields are returned as-is from the source, without fuzzy matching or verification scoring.

"kyb-prefill": [
    {
        "tin": "ABCD123456789",
        "name": "Company Name ABC",
        "entityType": "Company/Legal Entity",
        "registrationStatus": "Active",
        "taxIdEffectiveDate": "2025-07-17",
        "incorporationDate": "2025-05-29",
        "email": "[email protected]"
    }
]

Note: 'RFC is not found' message with a 200 code will be returned but not all keys will come back. As of now (June 30th), message is returned with registrationStatus key but will be revisited by July 2nd.

KYB Pre-fill error responses

Please refer to error response to see conventional HTTP response codes to indicate the success or failure of an API request.

Custom 400 error if taxId is missing, empty, or not 12–13 alphanumeric characters:

{
    "timestamp": 1782851408892,
    "status": 400,
    "error": "taxId must be a valid Mexican RFC: 12 or 13 alphanumeric characters (3-4 letters, 6 digits, 3 alphanumeric)",
    "message": "taxId must be a valid Mexican RFC: 12 or 13 alphanumeric characters (3-4 letters, 6 digits, 3 alphanumeric)",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Custom 400 error if any mandatory field (plugins, source, country, or taxId) is missing:

{
    "timestamp": 1782851468367,
    "status": 400,
    "error": "Bad Request",
    "message": "must not be blank",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Custom 400 error if wrong country code is provided (i.e anything other than MX):

{
    "timestamp": 1782851583695,
    "status": 400,
    "error": "Bad Request",
    "message": "IllegalArgumentException: No enum constant com.incodesmile.onboarding.integration.external.government.ekyb.domain.entity.model.EkybCountry.CO",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Single Session Dashboard Results

They are available on Single Session view under the Business tab.