Business Verification

Description

Retrieve comprehensive company information from Mexico including business and commercial names, complete address, contact details, company size, sales range, and economic activity (NAICS).

HTTP method POST

Endpoint

https://apidev.msla-id.com/experience-companyinfo-api-v1/api/idv-govcheck/v1/company/search

info

This endpoint requires Bearer Token authentication. Contact IT support to get credentials.

Query parameters

NAME	REQUIRED	TYPE	DEFAULT	DESCRIPTION
page	❌	integer	0	Page number (0-based)
size	❌	integer	10	Number of results per page

Pagination

Results are paginated. By default the endpoint returns up to 10 results per page. Use page and size query parameters to navigate through larger result sets.

Example: .../company/search?page=1&size=5 returns the second page, 5 results per page (results 5–9).

The response does not include total page or total element counts. Continue incrementing page until an empty companyList is returned to know there are no more results.

page must be >= 0 and size must be >= 1.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Content-Type	✅	string	application/json
Authorization	✅	string	Bearer JWT token

Request body parameters

NAME	REQUIRED	TYPE	DESCRIPTION
country	✅	string	MEX (Mexico)
taxID	✅	object	Tax identification object
taxID.identityNumber	❌	string	Tax identification number
taxID.checkDigit	❌	string	Not applicable for Mexico
companyName	❌	string	Company name (required if searchType=2)
searchType	✅	number	1 (by tax ID) or 2 (by company name)

Name search format

Only searchType=2 is supported for Mexico BV — searchType=1 (tax ID) returns error DOM-3007.

Allowed characters: only letters (A-Z, a-z, ñ, Ñ), numbers (0-9), and spaces are accepted. Accents, punctuation marks (., ,, ;, -, etc.) and any other special character are rejected with error - they are not stripped automatically, so remove them from the input before sending the request.
Minimum length: the companyName must be at least 5 characters long. Shorter values are rejected with error.

Examples:

✅ Valid: MARAPA SALUD S A, EMPRESA SRL, ABARROTES EL GALLO
❌ Invalid (format): MARAPA SALUD S.A., EMPRESA-S.A., Café S.A.
❌ Invalid (too short): ABC, CASA

Fuzzy matching

companyName search does not require an exact match. The endpoint uses trigram similarity against both company_name and commercial_name, with a similarity threshold of 0.5 (50%).

A candidate is returned if it is at least 50% similar to the search term on either field.
Results are ordered by the best similarity score first (closest match on top).
This means typos or partial names (e.g. ABAROTES EL GALO) can still return ABARROTES EL GALLO, as long as the similarity stays at or above 50%.

Request example

{
    "country": "MEX-BV",
    "taxID": {
        "identityNumber": "",
        "checkDigit": ""
    },
    "companyName": "ABARROTES EL GALLO",
    "searchType": 2
}

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error

Response 200 status code

{
    "traceId": "66aaef46b81d6ccd",
    "timestamp": "2026-05-12 15:26:35",
    "data": {
        "result": 1,
        "companyList": [
            {
                "id": "440607",
                "commercialName": "ABARROTES EL GALLO",
                "companyName": null,
                "naicsCode": "461110",
                "economicActivity": "COMERCIO AL POR MENOR EN TIENDAS DE ABARROTES, ULTRAMARINOS Y MISCELANEAS",
                "employeesRange": "0 A 5 PERSONAS",
                "typeOfRoad": "CALLE",
                "nameOfTheRoad": "3 SUR",
                "betweenRoadsType1": "AVENIDA",
                "nameOfBetweenRoads1": "27 PONIENTE",
                "betweenRoadType2": "AVENIDA",
                "nameOfBetweenRoads2": "29 PONIENTE",
                "betweenRoadType3": "CALLE",
                "nameOfBetweenRoads3": "16 DE SEPTIEMBRE",
                "outdoorNumberOrKilometer": "128",
                "outerLetter": null,
                "building": null,
                "apartmentBuilding": null,
                "interiorNumber": "5",
                "interiorLetter": null,
                "typeOfHumanSettlement": "COLONIA",
                "nameOfHumanSettlement": "EL CARMEN",
                "typeOfMall": null,
                "industrialCorridorShoppingMallOrPublicMarket": null,
                "numberOfLocal": null,
                "postalCode": "72530",
                "entityKey": "21",
                "federalEntity": "PUEBLA",
                "municipalityKey": "114",
                "municipality": "PUEBLA",
                "townKey": "0001",
                "location": "HEROICA PUEBLA DE ZARAGOZA",
                "basicGeostatisticsArea": "3737",
                "block": "010",
                "phoneNumber": "2222375513",
                "email": null,
                "website": null,
                "typeOfFacility": "FIJO",
                "latitude": "19.03456128000000",
                "length": "-98.20639390000000",
                "registrationDate": "2010-07"
            }
        ]
    }
}

Response 400 status code

{
  "traceId": "a1b2c3d4e5f6a7b8",
  "timestamp": "2026-08-12 12:00:00",
  "code": "DOM-2003",
  "message": "Invalid input format: company name must only contain letters (a-z, A-Z, n, N), numbers (0-9) and spaces. No accents or punctuation marks are allowed.",
  "data": null
}

{
  "traceId": "b2c3d4e5f6a7b8c9",
  "timestamp": "2026-08-12 12:01:00",
  "code": "DOM-2004",
  "message": "Company name must be at least 5 characters long.",
  "data": null
}

{
  "traceId": "c3d4e5f6a7b8c9d0",
  "timestamp": "2026-08-12 12:02:00",
  "code": "DOM-2005",
  "message": "Page must be >= 0.",
  "data": null
}

{
  "traceId": "d4e5f6a7b8c9d0e1",
  "timestamp": "2026-08-12 12:03:00",
  "code": "DOM-2006",
  "message": "Size must be >= 1.",
  "data": null
}

{
  "traceId": "d87a4061098d1597",
  "timestamp": "2026-05-13 15:03:55",
  "code": "DOM-3007",
  "message": "Search type 1 (taxId) is not supported for Mexico BV. Use search type 2 (company name).",
  "data": null
}

{
    "traceId": "51ae18b2479f33a1",
    "timestamp": "2026-05-13 15:31:32",
    "code": "DOM-3020",
    "message": "Country not supported.",
    "data": null
}

Response 404 status code

{
  "traceId": "0f4224cc97f11b40",
  "timestamp": "2026-05-13 15:04:55",
  "code": "IDV-1002",
  "message": "Data not found.",
  "data": null
}

Response 401 status code

{
    "timestamp": "2025-03-16T11:20:46.000Z",
    "status": 401,
    "error": "Unauthorized",
    "message": "Bearer token is missing or invalid",
    "path": "/api/idv-govcheck/v1/company/search"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "2025-03-16 11:20:46",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}

Error codes

Code	Message
DOM-2003	Invalid input format: company name must only contain letters (a-z, A-Z, n, N), numbers (0-9) and spaces. No accents or punctuation marks are allowed.
DOM-2004	Company name must be at least 5 characters long
DOM-2005	Page must be >= 0
DOM-2006	Size must be >= 1
DOM-3007	Search type 1 (taxId) is not supported for Mexico BV
DOM-3020	Country not supported
IDV-1002	Data not found
IDV-1001	A generic error has occurred

Business Verification

Description​

HTTP method POST​

Endpoint​

Query parameters​

Request header parameter​

Request body parameters​

Fuzzy matching​

Request example​

Status code responses​

Response 200 status code​

Response 400 status code​

Response 404 status code​

Response 401 status code​

Response 500 status code​

Error codes​