DocumentationAPI Reference
General reference · eKYB Reference / eKYB Prefill Coverage

Mexico

eKYB Prefill in Mexico leverages Mexico's source of truth to automatically retrieve and populate business information based on a company's RFC, including the business name, entity type, registration status, incorporation date, and contact details, without requiring manual input from the user.

Source

Country Source Description
Mexico MX_KYB_PREFILL Returns matching Mexican business details from Mexico's source of truth for pre-fill.

Direct API approach

For general integration notes and shared response semantics, see the eKYB Prefill API Reference.

All module configurations and user data can be forwarded directly in the request for performing a Prefill lookup. This overrides existing configuration and data collected about the user.

Endpoint

POST /omni/externalVerification/ekyb-prefill

Request parameters

Parameter Required Description
plugins Mandatory String array. Must be ["ekyb-prefill"]. Specifies the Prefill flow.
source Mandatory String. Must be MX_KYB_PREFILL. Identifies the Prefill source.
country Mandatory String. Two-letter Alpha-2 country code. Must be MX.
taxId Mandatory String. RFC (Registro Federal de Contribuyentes). See Tax ID formats for details.

Tax ID formats

RFC (Registro Federal de Contribuyentes) is the Mexican federal tax identifier. Input must be 12 or 13 alphanumeric characters. Requests with an invalid format return a 400 error.

Entity Type Format
Individual 12 characters: 4 letters + 6 digits + 3 alphanumeric characters (for example: AIGB850818QJ9) {/* TODO: Confirm with PM — the source states 12 characters for individuals but the example AIGB850818QJ9 is 13 characters. Confirm the correct format. */}
Legal entity 13 characters: 3 letters + 6 digits + 3 alphanumeric characters (for example: CSE250529PSA) {/* TODO: Confirm with PM — the source states 13 characters for legal entities but the example CSE250529PSA is 12 characters. Confirm the correct format. */}

Sample request

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

Sample response

The Prefill 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": "sampleemail@gmail.com"
    }
  ]
}

Info

When an RFC is not found, the response returns a 200 status code with a message indicating the RFC could not be located. Not all keys are returned in this case. iness name, entity type, registration status, incorporation date, and contact details, without requiring manual input from the user.

Response fields

Key Value Description
tin RFC number The tax ID submitted in the request, as returned and confirmed by the source of truth.
name Business name The registered legal name of the business as returned from the source of truth.
entityType Entity type The legal entity type of the business (for example, Company/Legal Entity, Individual/Sole Proprietorship).
registrationStatus Active, Expired, Unknown, Not Found Current registration status of the business. See Registration status values for details.
taxIdEffectiveDate Date The date from which the RFC became effective.
incorporationDate Date The date the business was incorporated.
email Email address The business contact email address registered with the source of truth, if available.

Registration status values

Status Description
Active The RFC is currently registered and active (Vigente).
Expired The RFC registration has lapsed (Expirado).
Unknown The registration status could not be determined.
Not Found The RFC is inactive or could not be found in the source of truth.

Error responses

For standard HTTP response codes, see the API Error Response page. Mexico Prefill returns the following country-specific 400 errors.

taxId is missing, empty, or not 12 to 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"
}

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"
}

Wrong country code is provided (any value 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

Prefill results are available on the Business tab in single Session view.

Was this page helpful?