cronotaDocumentação da API

/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.

Server URLhttps://cronota.clowk.in/api/v1
GET/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ório

Com ou sem pontuação. Aceita o CNPJ alfanumérico.

Respostas

200A empresa.
objectstringopcional
documentstringopcional
namestringopcional

Razão social.

trade_namestring | nullopcional

Nome fantasia.

statusstring | nullopcional

Situação cadastral na Receita: ATIVA, BAIXADA, INAPTA, SUSPENSA ou NULA.

main_activityobject | nullopcional

O CNAE principal.

codestringopcional
descriptionstringopcional
emailstring | nullopcional
Formato email
phonestring | nullopcional
simplesbooleanopcional

Optante pelo Simples Nacional.

meibooleanopcional

Microempreendedor individual.

addressobjectopcional

No Brasil: zipcode, street, number, neighborhood, municipality_code (IBGE, 7 dígitos), city, state. No exterior: country, street, postal_code, city, region.

zipcodestringopcional
streetstringopcional
numberstringopcional
complementstringopcional
neighborhoodstringopcional
municipality_codestringopcional
citystringopcional
statestringopcional
countrystringopcional
postal_codestringopcional
regionstringopcional
fetched_atstringopcional

Quando o dado foi lido na fonte.

Formato date-time
400Os dígitos verificadores não conferem.
errorobjectopcional
codestringopcional

Estável, para o seu código decidir.

messagestringopcional

Para pessoas, em português.

fieldsobjectopcional

Nos 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.
errorobjectopcional
codestringopcional

Estável, para o seu código decidir.

messagestringopcional

Para pessoas, em português.

fieldsobjectopcional

Nos 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`.
errorobjectopcional
codestringopcional

Estável, para o seu código decidir.

messagestringopcional

Para pessoas, em português.

fieldsobjectopcional

Nos 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.
errorobjectopcional
codestringopcional

Estável, para o seu código decidir.

messagestringopcional

Para pessoas, em português.

fieldsobjectopcional

Nos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).