Brazil CNPJ Fetch

Overview

The Brazil CNPJ Fetch API is designed to retrieve detailed information associated with a given CNPJ number.

CNPJ (Cadastro Nacional da Pessoa Jurídica) is the Brazilian National Registry of Legal Entities. It's a unique identification number issued to companies and other legal entities by the Brazilian Federal Revenue (Receita Federal do Brasil). Think of it as the corporate equivalent of a CPF (Cadastro de Pessoas Físicas) for individuals in Brazil.

A CNPJ is used for tax purposes, legal identification, and commercial transactions. It ensures that businesses are registered and recognized by government and financial institutions.

Use Case

This API is crucial for a variety of business processes that require reliable identity verification in Brazil, such as:

Financial Services: Validating company identity during corporate account opening, credit evaluation, and loan approvals to prevent fraud and ensure regulatory compliance.

E-commerce & Marketplaces: Verifying vendor or seller CNPJ during onboarding to prevent fraudulent or unregistered businesses from operating on the platform.

Supply Chain & Procurement: Ensuring suppliers or distributors are legitimate and active legal entities before engaging in contracts or transactions.

Tax & Accounting Compliance: Validating CNPJ for issuing or receiving electronic invoices (NF-e), and ensuring compliance with Brazilian tax regulations.

KYB/Compliance Platforms: Conducting Know Your Business (KYB) checks to meet anti-money laundering (AML) and due diligence requirements.

Legal & Contractual Validations: Checking the legitimacy of business entities before signing contracts or entering into legal agreements.

API Details

Request Body

curl --location 'https://api.signzy.app/api/v3/global-kyc-fetch/br/cnpj' \
--header 'Authorization: <----Auth Token---->' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cnpj": "33.592.510/0001-54"
}'

Request Body Parameters

Parameter	Type	Description	Required
cnpj	string	The CNPJ number to fetch details for. Can be of "00000000000000" or "00.000.000/0000-00" either of the two regex.	Yes

Response Body

{
    "result": {
        "registrationNumber": "33.592.510/0001-54",
        "isHeadOffice": true,
        "openingDate": "1969-02-11T00:00:00.0000000",
        "corporateName": "VALE S.A.",
        "tradeName": "********",
        "mainEconomicActivity": "07.10-3-01 - Extração de minério de ferro",
        "mainEconomicActivityTranslated": "07.10-3-01 - Iron ore extraction",
        "mainEconomicActivityCodeNorm": "07.10-3-01",
        "mainEconomicActivityCodeNumberNorm": "710301",
        "mainEconomicActivityDescriptionNorm": "Extração de minério de ferro",
        "mainEconomicActivityDescriptionNormTranslated": "Iron ore extraction",
        "secondaryEconomicActivity": [
            "09.90-4-01 - Atividades de apoio à extração de minério de ferro",
            "82.11-3-00 - Serviços combinados de escritório e apoio administrativo"
        ],
        "secondaryEconomicActivityTranslated": [
            "09.90-4-01 - Support activities for iron ore extraction",
            "82.11-3-00 - Combined office and administrative support services"
        ],
        "secondaryEconomicActivityNorm": [
            {
                "activityCode": "09.90-4-01",
                "activityCodeNumber": "0990401",
                "activityDescription": "Atividades de apoio à extração de minério de ferro",
                "activityDescriptionTranslated": "Activities supporting iron ore extraction"
            },
            {
                "activityCode": "82.11-3-00",
                "activityCodeNumber": "8211300",
                "activityDescription": "Serviços combinados de escritório e apoio administrativo",
                "activityDescriptionTranslated": "Combined office and administrative support services"
            }
        ],
        "legalNature": "204-6 - Sociedade Anônima Aberta",
        "legalNatureTranslated": "204-6 - Public Limited Company",
        "street": "PR BOTAFOGO",
        "number": "00186",
        "complement": "SAL 901 1101 1601 PARTE 1701 1801",
        "postalCode": "22.250-145",
        "district": "BOTAFOGO",
        "city": "RIO DE JANEIRO",
        "state": "RJ",
        "registrationStatus": "ATIVA",
        "registrationStatusTranslated": "ACTIVE",
        "registrationStatusDate": "2005-11-03T00:00:00.0000000",
        "issueDate": "2025-06-19T07:37:14.0000000",
        "phoneNumber": "(21) 3485-5000/ (21) 3485-6600",
        "entityOfFederalRegistration": "*****",
        "entityOfFederalRegistrationTranslated": "*****",
        "companySize": "DEMAIS",
        "companySizeTranslated": "TOO MUCH",
        "legalNatureCodeNorm": "204-6",
        "legalNatureCodeNumberNorm": 2046,
        "legalNatureDescriptionNorm": "Sociedade Anônima Aberta",
        "legalNatureDescriptionNormTranslated": "Public Limited Company",
        "postalCodeNorm": 22250145,
        "companyShareholderInfo": {
            "socialCapital": "R$77.300.000.000,00 (Setenta e sete bilhões, trezentos milhões de reais)",
            "socialCapitalTranslated": "R$77,300,000,000.00 (Seventy-seven billion, three hundred million reais)",
            "socialCapitalNorm": 77300000000,
            "partnersList": [
                {
                    "partnerName": "RAFAEL JABUR BITTAR",
                    "qualification": "10-Diretor",
                    "qualificationTranslated": "10-Director",
                    "legalRepQualification": "",
                    "legalRepName": "",
                    "countryOfOrigin": "",
                    "type": 0
                },
                {
                    "partnerName": "ROGERIO TAVARES NOGUEIRA",
                    "qualification": "10-Diretor",
                    "qualificationTranslated": "10-Director",
                    "legalRepQualification": "",
                    "legalRepName": "",
                    "countryOfOrigin": "",
                    "type": 0
                },
                {
                    "partnerName": "MARCELO FERIOZZI BACCI",
                    "qualification": "10-Diretor",
                    "qualificationTranslated": "10-Director",
                    "legalRepQualification": "",
                    "legalRepName": "",
                    "countryOfOrigin": "",
                    "type": 0
                },
                {
                    "partnerName": "SAMI ARAP SOBRINHO",
                    "qualification": "10-Diretor",
                    "qualificationTranslated": "10-Director",
                    "legalRepQualification": "",
                    "legalRepName": "",
                    "countryOfOrigin": "",
                    "type": 0
                },
                {
                    "partnerName": "GUSTAVO DUARTE PIMENTA",
                    "qualification": "16-Presidente",
                    "qualificationTranslated": "16-President",
                    "legalRepQualification": "",
                    "legalRepName": "",
                    "countryOfOrigin": "",
                    "type": 0
                },
                {
                    "partnerName": "CARLOS HENRIQUE SENNA MEDEIROS",
                    "qualification": "10-Diretor",
                    "qualificationTranslated": "10-Director",
                    "legalRepQualification": "",
                    "legalRepName": "",
                    "countryOfOrigin": "",
                    "type": 0
                }
            ]
        }
    },
    "reason": "Request Successful",
    "status": "success",
    "code": "S001"
}

Response Body Parameters

Parameter	Type	Description
registrationNumber	String	CNPJ number of the company
isHeadOffice	Boolean	Indicates if the entity is a head office
openingDate	String	Date the company was established
corporateName	String	Legal name of the company
tradeName	string	Trading name or brand name of the company
mainEconomicActivity	String	Main line of business or economic activity
mainEconomicActivityTranslated	String	Main line of business or economic activity translated in english
mainEconomicActivityCodeNorm	String	Normalized code of main economic activity
mainEconomicActivityCodeNumberNorm	String	Numeric normalized code of main economic activity
mainEconomicActivityDescriptionNorm	String	Normalized description of main economic activity
secondaryEconomicActivity	Array	Secondary line of business or economic activity
secondaryEconomicActivityTranslated	Array	Secondary line of business or economic activity translated in english.
secondaryEconomicActivityNorm	Array	Normalized code of main secondary activity
activityCode	String	Code of the secondary economic activity
activityCodeNumber	String	Numeric code of the secondary economic activity
activityDescription	String	Description of the secondary economic activity
activityDescriptionTranslated	String	Description of the secondary economic activity translated in english
legalNature	String	Legal classification of the business
legalNatureTranslated	String	Legal classification of the business
street	String	Street name of the company address
number	String	Street number of the company address
postalCode	String	Postal code (CEP) of the address
district	String	Neighborhood or district of the company address
state	String	Federal state abbreviation
city	String	City where the company is located
registrationStatus	String	Current registration status of the company
registrationStatusTranslated	String	Current registration status of the company
registrationStatusDate	String	Date the registration status was updated
issueDate	String	Issue date of CNPJ certificate
phoneNumber	String	Primary phone number
entityOfFederalRegistration	String	The acronym for the Entity of Federal Registration (Entidade Federativa Responsável). It indicates the governmental or institutional authority responsible for the registration and maintenance of that legal entity's CNPJ information
entityOfFederalRegistrationTranslated	String	The acronym for the Entity of Federal Registration (Entidade Federativa Responsável). It indicates the governmental or institutional authority responsible for the registration and maintenance of that legal entity's CNPJ information
companySize	String	Size classification of the company
companySizeTranslated	String	Size classification of the company
legalNatureCodeNorm	String	Normalized code of the company's legal nature
legalNatureCodeNumberNorm	Integer	Normalized numeric code of the company's legal nature
legalNatureDescriptionNorm	String	Normalized description of the company's legal nature
legalNatureDescriptionNormTranslated	String	Normalized description of the company's legal nature
postalCodeNorm	Integer	Postal code in numeric format
companyShareholderInfo	Object	Composite structure containing company capital and list of shareholders or officers
socialCapital	String	Declared capital of the company in local currency (formatted)
socialCapitalTranslated	String	Declared capital of the company in local currency (formatted)
socialCapitalNorm	Integer	Declared capital of the company in numeric format
partnersList	Array	List of all partners
partnerName	String	Name of the company officer or partner
qualification	String	Position or title of the partner
qualificationTranslated	String	Position or title of the partner
legalRepQualification	String	Qualification of the legal representative
legalRepName	String	Name of the legal representative
countryOfOrigin	String	Country of origin of the partner
type	Boolean	Type indicator (e.g., individual or company)

Sample Error

{
    "result": {},
    "reason": "Bad Request: cnpj cannot be empty",
    "status": "failure",
    "code": "E001"
}

Success Codes

HTTP Status Code	Success Code	Description
200	S001	Request Successful.
200	S003	Data not Found on source.

Error Response Parameters

Parameter	Description
result	Empty result object
reason	Reason for error
status	Status of the api
code	Error code from Signzy

Error Codes

HTTP Status Code	Error Code	Description
400	E001	Bad Request
401	E1001	Unauthorized Access
403	E201	Forbidden
404	E301	Data Not Found
409	E401	Upstream error
429	E501	Rate Limit Exceeded
500	E601	Internal Server Error
503	E701	Service Unavailable
504	E801	Timeout

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!