Microempreendedor Individual (MEI)

Description

The Brazil Microempreendedor Individual (MEI) service checks whether a company establishment is opted into the MEI tax regime. The response returns one establishment record, including registration, address, activities, Simples option and MEI option. The field meiOptIn states whether the establishment is currently opted into MEI.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-taxes-api-v1/api/idv-govcheck/v1/br-identity/{documentNumber}/check-microempreendedor-individual

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
documentNumber	✅	string	Brazilian company taxpayer number (CNPJ), 14 digits.	00000000000191

Status code responses

Code	Description
200	OK
400	Bad request — IDV-3001
401	Unauthorized
403	Forbidden — IDV-1004
404	Not found — IDV-1002 Data not found.
500	Internal server error — IDV-1008
504	Gateway timeout — IDV-1100

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "4f999ecc5ba99e79",
    "timestamp": "2026-10-05 16:31:25",
    "data": {
        "cnpj": "00000000000191",
        "basicCnpj": "00000000",
        "companyName": "EMPRESA EXEMPLO FICTICIA 00000000000",
        "legalNature": "EMPRESARIO INDIVIDUAL",
        "responsibleQualification": "EMPRESARIO",
        "companyCapital": "1000.00",
        "companySize": "MICRO EMPRESA",
        "responsibleFederativeEntity": null,
        "headquarterBranchIdentifier": "MATRIZ",
        "tradeName": null,
        "registrationStatus": "ATIVA",
        "registrationStatusDate": "2020-01-15",
        "registrationStatusReason": "SEM MOTIVO",
        "foreignCityName": null,
        "country": null,
        "startDateOfActivity": "2020-01-15",
        "mainCnae": "FORNECIMENTO DE ALIMENTOS PREPARADOS PREPONDERANTEMENTE PARA CONSUMO DOMICILIAR",
        "secondaryCnae": null,
        "streetType": "RUA",
        "street": "EXEMPLO",
        "number": "100",
        "complement": null,
        "neighborhood": "CENTRO",
        "zipCode": "00000000",
        "state": "SP",
        "municipality": "SAO PAULO",
        "ddd1": "11",
        "telephone1": "900000000",
        "ddd2": null,
        "telephone2": null,
        "dddFax": null,
        "fax": null,
        "email": "contato@example.com",
        "specialSituation": null,
        "specialSituationDate": null,
        "simplesOptIn": "S",
        "simplesOptInDate": "2020-01-15",
        "simplesOptOutDate": null,
        "meiOptIn": "S",
        "meiOptInDate": "2020-01-15",
        "meiOptOutDate": null
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3001",
    "message": "Bad request - Invalid or incomplete input data",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/br-identity/{documentNumber}/check-microempreendedor-individual"
}

Response 403 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1004",
    "message": "Access denied.",
    "data": null
}

Response 404 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1002",
    "message": "Data not found.",
    "data": null
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration.",
    "data": null
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}