Microempreendedor Individual (MEI)

Description

Query on the Portal do Empreendedor to verify if a person is registered as an Individual Micro Entrepreneur (MEI).

HTTP method GET

Endpoint

https://8ehec73psb.execute-api.us-west-2.amazonaws.com/uat/identity/api/idv-govcheck/v1/br-identity/{documentNumber}/check-microempreendedor-individual

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
CPF	✅	string	Brazilian id number
DOB	✅	string	Date of birth (format: YYYY-MM-DD)

Status code responses

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

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "b2345cfc7bee621e",
    "timestamp": "2023-05-15 11:59:35",
    "data": {
        "PersonBasicData": {
            "Name": "ANTONIO JOSE BRAVO ALVES",
            "BirthDate": "1957-08-01T00:00:00Z",
            "BirthCountry": "BRASILEIRA",
            "MotherName": "LENIR BRAVO ALVES",
            "FatherName": "",
            "TaxIdStatus": "REGULAR",
            "TaxIdOrigin": "RECEITA FEDERAL",
            "TaxIdFiscalRegion": "ES-RJ",
            "HasObitIndication": false,
            "TaxIdStatusDate": "2022-06-30T00:00:00",
            "CreationDate": "2016-08-23T00:00:00Z",
            "LastUpdateDate": "2022-09-10T00:00:00Z"
        },
        "CurrentQSARelationships": {
            "TotalCurrentRelationships": 9,
            "BusinessRelationships": [
                {
                    "RelatedEntityTaxIdType": "CNPJ",
                    "RelationshipName": "CONSELHEIRO DE ADMINISTRACAO",
                    "RelationshipType": "OWNERSHIP",
                    "RelationshipSubtype": "OTHER",
                    "RelationshipLevel": "DIRECT",
                    "RelatedEntityTaxIdCountry": "Brazil",
                    "RelatedCompanyBasicData": {
                        "TaxIdNumber": "08768627000107",
                        "TaxIdCountry": "Brazil",
                        "AlternativeIdNumbers": {},
                        "OfficialName": "BIG DATA SOLUCOES EM TECNOLOGIA DE INFORMATICA S.A.",
                        "TradeName": "BIG DATA CORP",
                        "Aliases": {},
                        "FoundedDate": "2007-04-03T00:00:00Z",
                        "Age": 15,
                        "IsHeadquarter": true,
                        "HeadquarterState": "RJ",
                        "IsConglomerate": false,
                        "TaxIdStatus": "ATIVA",
                        "TaxIdOrigin": "Receita Federal",
                        "TaxIdStatusDate": "2022-08-09T00:00:00Z",
                        "TaxIdStatusRegistrationDate": "2007-04-03T00:00:00Z",
                        "TaxRegime": "S.A.",
                        "CompanyType_ReceitaFederal": "DEMAIS",
                        "TaxRegimes": {
                            "Simples": false
                        },
                        "Activities": [
                            {
                                "IsMain": true,
                                "Code": "6201501",
                                "Activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA"
                            },
                            {
                                "IsMain": false,
                                "Code": "6204000",
                                "Activity": "CONSULTORIA EM TECNOLOGIA DA INFORMACAO"
                            },
                            {
                                "IsMain": false,
                                "Code": "6399200",
                                "Activity": "OUTRAS ATIVIDADES DE PRESTACAO DE SERVICOS DE INFORMACAO NAO ESPECIFICADAS ANTERIORMENTE"
                            }
                        ],
                        "LegalNature": {
                            "Code": "2054",
                            "Activity": "SOCIEDADE ANONIMA FECHADA"
                        },
                        "SpecialSituation": "",
                        "CreationDate": "2013-09-04T00:00:00Z",
                        "LastUpdateDate": "2022-09-19T00:00:00Z",
                        "AdditionalOutputData": {
                            "Capital": "CEM MIL REAIS",
                            "CapitalRS": "100000.00",
                            "NIRE": ""
                        },
                        "HistoricalData": {
                            "HasChangedTradeName": false,
                            "HasChangedTaxRegime": true,
                            "HistoricalDataEvolution": {
                                "TradeName": [
                                    {
                                        "Value": "BIG DATA CORP",
                                        "StartDate": "2013-09-04T00: 00: 00Z"
                                    }
                                ],
                                "TaxRegime": [
                                    {
                                        "Value": "S.A.",
                                        "StartDate": "2021-12-01T00:00:00Z"
                                    },
                                    {
                                        "Value": "LTDA",
                                        "StartDate": "2018-07-01T00:00:00Z",
                                        "EndDate": "2021-12-01T00:00:00Z"
                                    },
                                    {
                                        "Value": "ME",
                                        "StartDate": "2018-06-01T00:00:00Z",
                                        "EndDate": "2018-07-01T00:00:00Z"
                                    },
                                    {
                                        "Value": "SIMPLES",
                                        "StartDate": "2017-08-01T00:00:00Z",
                                        "EndDate": "2018-06-01T00:00:00Z"
                                    },
                                    {
                                        "Value": "LUCRO PRESUMIDO",
                                        "StartDate": "2017-03-01T00:00:00Z",
                                        "EndDate": "2017-08-01T00:00:00Z"
                                    },
                                    {
                                        "Value": "EPP",
                                        "StartDate": "2013-09-04T00:00:00Z",
                                        "EndDate": "2017-03-01T00:00:00Z"
                                    }
                                ]
                            }
                        }
                    }
                }
            ]
        }
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-4005",
    "message": "-",
    "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 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}