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 preproduction curl location 'https //api preproduction 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" }' production 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 successful response { "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" } data not found { "result" {}, "reason" "data not found", "status" "success", "code" "s003" } 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 e601 internal server error { "result" {}, "reason" "internal server error", "status" "failure", "code" "e601" } e001 invalid regex for cnpj { "result" {}, "reason" "bad request cnpj number is invalid please check the input and try again ", "status" "failure", "code" "e001" } e001 empty cnpj { "result" {}, "reason" "bad request cnpj cannot be empty", "status" "failure", "code" "e001" } e401 upstream failure { "result" {}, "reason" "upstream error", "status" "failure", "code" "e401" } 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 s tatus of the api c ode 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 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!