/companies/{cnpj}
Os dados públicos de uma empresa na Receita Federal: razão social, situação cadastral, CNAE principal, Simples/MEI e endereço com o código IBGE. Use antes de cadastrar o tomador ou de emitir a nota. Vale em todos os planos. Cada chave faz até 60 consultas por minuto; acima disso, 429 com o header Retry-After. A resposta vem de um cache (7 dias para uma empresa, 1 hora para um CNPJ inexistente) e fetched_at diz quando o dado foi lido na fonte.
https://cronota.clowk.in/api/v1/companies/{cnpj}Autorização
Bearer token: sk_live_… (Live) ou sk_test_… (Sandbox). A chave define a empresa e o ambiente.
Parâmetros
cnpjstring · pathobrigatórioCom ou sem pontuação. Aceita o CNPJ alfanumérico.
Respostas
200A empresa.
objectstringopcionaldocumentstringopcionalnamestringopcionalRazão social.
trade_namestring | nullopcionalNome fantasia.
statusstring | nullopcionalSituação cadastral na Receita: ATIVA, BAIXADA, INAPTA, SUSPENSA ou NULA.
main_activityobject | nullopcionalO CNAE principal.
codestringopcionaldescriptionstringopcionalemailstring | nullopcionalphonestring | nullopcionalsimplesbooleanopcionalOptante pelo Simples Nacional.
meibooleanopcionalMicroempreendedor individual.
addressobjectopcionalNo Brasil: zipcode, street, number, neighborhood, municipality_code (IBGE, 7 dígitos), city, state. No exterior: country, street, postal_code, city, region.
zipcodestringopcionalstreetstringopcionalnumberstringopcionalcomplementstringopcionalneighborhoodstringopcionalmunicipality_codestringopcionalcitystringopcionalstatestringopcionalcountrystringopcionalpostal_codestringopcionalregionstringopcionalfetched_atstringopcionalQuando o dado foi lido na fonte.
400Os dígitos verificadores não conferem.
errorobjectopcionalcodestringopcionalEstável, para o seu código decidir.
messagestringopcionalPara pessoas, em português.
fieldsobjectopcionalNos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).
404A Receita Federal não tem este CNPJ.
errorobjectopcionalcodestringopcionalEstável, para o seu código decidir.
messagestringopcionalPara pessoas, em português.
fieldsobjectopcionalNos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).
429Mais de 60 consultas no mesmo minuto com esta chave. Espere o tempo de `Retry-After`.
errorobjectopcionalcodestringopcionalEstável, para o seu código decidir.
messagestringopcionalPara pessoas, em português.
fieldsobjectopcionalNos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).
503As fontes da consulta não responderam. Tente de novo em alguns minutos.
errorobjectopcionalcodestringopcionalEstável, para o seu código decidir.
messagestringopcionalPara pessoas, em português.
fieldsobjectopcionalNos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).