# Visão Geral

[![Run in Insomnia](https://insomnia.rest/images/run.svg)](https://insomnia.rest/run/?label=CNPJ.ws\&uri=https%3A%2F%2Fwww.cnpj.ws%2Finsomnia.json)

A API do **CNPJ.ws** fornece, de maneira simples e rápida, dados sobre empresas brasileiras através do número do CNPJ. Esses dados são obtidos junto a órgãos públicos como a SEFAZ, CADESP, Sintegra, Suframa e são organizados para permitir o máximo de informações úteis, ampliando as possibilidades de uso desses dados.

## Estrutura básica do JSON

Os dados são estruturados para trazer a maior quantidade de informações úteis, possibilitando a integração com diversos sistemas.

Tipos de dados utilizados:

| Sigla | Descrição |
| :---: | --------- |
|   A   | Array     |
|   S   | String    |
|   D   | Data      |
|   N   | Numérico  |
|   O   | Objeto    |

Abaixo está a estrutura básica retornada pela API de CNPJ:

| Campo                         | Tipo | Descrição                                    |
| ----------------------------- | :--: | -------------------------------------------- |
| cnpj\_raiz                    |   S  | Raiz do CNPJ                                 |
| razao\_social                 |   S  | Razão social da empresa                      |
| capital\_social               |   S  | Capital social                               |
| responsavel\_federativo       |   S  | Responsável federativo                       |
| criado\_em                    |   S  | Data do cadastro na base de dados do CNPJ.ws |
| atualizado\_em                |   S  | Data da última atualização das informações   |
| porte                         |   O  | Porte da empresa                             |
| natureza\_juridica            |   O  | Natureza jurídica                            |
| qualificacao\_do\_responsavel |   O  | Qualificação do responsável                  |
| socios                        |   O  | Lista de Sócios                              |
| estabelecimento               |   O  | Estabelecimento                              |
| simples                       |   O  | Dados do Simples e do MEI                    |

## Defasagem dos Dados

A defasagem máxima dos dados é de 45 dias, sendo que diariamente são feitas integrações com os Sintegras estaduais com os quais possuímos integração.

Qualquer dúvida, estamos aqui para te apoiar! Mande um e-mail para <contato@cnpj.ws>!

[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg)](https://www.digitalocean.com/?refcode=58b7deafafad\&utm_campaign=Referral_Invite\&utm_medium=Referral_Program\&utm_source=badge)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cnpj.ws/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.