# Cadastro Empresarial - Básico

> Consulta dados cadastrais de um CNPJ, retornando informações como razão social, atividades econômicas, dados societários, contatos e estimativa de faturamento.

- **Consulta:** `cadastro-pj-basica`
- **Categoria:** Pessoa Jurídica
- **Preço:** R$ 0,32 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/cadastro-pj-basica`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/pessoa-juridica/cadastro-pj-basica

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Recupera dados cadastrais completos de pessoas jurídicas consultando o CNPJ. O endpoint integra informações de registro oficial com análises estatísticas para fornecer visão abrangente sobre a empresa, incluindo estrutura organizacional, atividades econômicas, força de trabalho estimada e perspectivas de faturamento.
>
> Indicado para processos de qualificação e onboarding de fornecedores, avaliação de risco de crédito, due diligence regulatória e enriquecimento de bases de dados B2B.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/cadastro-pj-basica?cnpj=SEU_CNPJ"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/cadastro-pj-basica",
    params={"cnpj": "SEU_CNPJ"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/cadastro-pj-basica");

url.search = new URLSearchParams({
  "cnpj": "SEU_CNPJ"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cnpj` | CNPJ | sim | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> **Identificação**
> - `cnpj`: Número registrado
> - `razaoSocial`: Denominação oficial
> - `nomeFantasia`: Nome comercial
> - `tipoEmpresa`: Categoria empresarial
> - `dataFundacao`: Data de constituição
>
> **Atividade Econômica**
> - `cnaeCodigo`: Código da atividade principal
> - `cnaeDescricao`: Descrição da atividade principal
> - `cnaEsSecundarios`: Códigos e descrições de atividades complementares
> - `ramo`: Setor de atuação
> - `naturezaJuridicaCodigo`, `naturezaJuridicaDescricao`, `naturezaJuridicaTipo`: Enquadramento legal
>
> **Características Operacionais**
> - `porte`: Classificação (MEI, ME, EPP, médio, grande)
> - `quantidadeFuncionarios`: Efetivo de colaboradores
> - `faixaFuncionarios`: Faixa estimada
> - `faixaFaturamento`: Faixa de receita presumida
> - `situacaoCadastral`: Status de registro
> - `ultimaAtualizacaoPJ`: Última atualização dos dados
>
> **Sociedade**
> - `socios`: Relação com documento, nome, participação percentual, data de entrada e função
> - `matriz`: Booleano indicando se é unidade-matriz
>
> **Contato e Localização**
> - `enderecos`: Lista com logradouro, número, complemento, bairro, cidade, UF e CEP
> - `telefones`: Números com DDD, tipo, operadora, status de bloqueio telemarketing e WhatsApp
> - `emails`: Endereços eletrônicos associados
>
> **Complementares**
> - `orgaoPublico`: Vinculação com administração pública

### Exemplo de resposta

```json
{
  "cnpj": "11111111000111",
  "ramo": null,
  "porte": "GRANDE",
  "emails": [
    {
      "enderecoEmail": "financeiro@exemplo.com.br"
    },
    {
      "enderecoEmail": "contato@exemplo.com.br"
    },
    {
      "enderecoEmail": "juridico@exemplo.com.br"
    }
  ],
  "matriz": true,
  "socios": [
    {
      "nome": "HOLDING INTERNACIONAL NORTE LTDA",
      "cargo": "Sócio Pessoa Jurídica Domiciliado no Exterior",
      "documento": "22.222.222/0001-22",
      "dataEntrada": "01/09/2004 00:00:00",
      "percentualParticipacao": null
    },
    {
      "nome": "PARTICIPACOES GLOBAL SUL LTDA",
      "cargo": "Sócio Pessoa Jurídica Domiciliado no Exterior",
      "documento": "33.333.333/0001-33",
      "dataEntrada": "01/09/2004 00:00:00",
      "percentualParticipacao": null
    },
    {
      "nome": "FERNANDO AUGUSTO RIBEIRO DIAS",
      "cargo": "Administrador",
      "documento": "111.111.111-11",
      "dataEntrada": "26/08/2014 00:00:00",
      "percentualParticipacao": null
    }
  ],
  "enderecos": [
    {
      "uf": "SP",
      "cep": "01310-100",
      "bairro": "Bela Vista",
      "cidade": "SAO PAULO",
      "numero": "3477",
      "logradouro": "Avenida Paulista",
      "complemento": "Andar 15"
    },
    {
      "uf": "MG",
      "cep": "30130-010",
      "bairro": "Centro",
      "cidade": "BELO HORIZONTE",
      "numero": "3900",
      "logradouro": "Avenida Afonso Pena",
      "complemento": "Sala 8"
    }
  ],
  "telefones": [
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "11999990002",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "11999990003",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "11999990004",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "11999990005",
      "telemarketingBloqueado": null
    },
    {
      "whatsApp": null,
      "operadora": null,
      "tipoTelefone": null,
      "telefoneComDDD": "11999990006",
      "telemarketingBloqueado": null
    }
  ],
  "cnaeCodigo": 6319400,
  "razaoSocial": "PORTAL DE SERVICOS DIGITAIS HORIZONTE LTDA",
  "tipoEmpresa": "LTDA",
  "dataFundacao": "01/09/2004 00:00:00",
  "nomeFantasia": null,
  "orgaoPublico": null,
  "cnaeDescricao": "Portais, provedores de conteúdo e outros serviços de informação na internet",
  "cnaEsSecundarios": [],
  "faixaFaturamento": "De R$ 500,1 MM A R$ 600,0 MM",
  "faixaFuncionarios": "Mais Que 200 Funcionários",
  "situacaoCadastral": "ATIVA",
  "ultimaAtualizacaoPJ": null,
  "naturezaJuridicaTipo": null,
  "naturezaJuridicaCodigo": 2062,
  "quantidadeFuncionarios": 235,
  "naturezaJuridicaDescricao": "Sociedade Empresária Limitada"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ da empresa."
    },
    "ramo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Ramo de atividade da empresa."
    },
    "porte": {
      "type": [
        "string",
        "null"
      ],
      "description": "Porte ou tamanho da empresa (ex.: `MICRO`, `PEQUENA`, `GRANDE`, `MEI`, `ME`, `EPP`)."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "enderecoEmail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço de e-mail."
          }
        }
      },
      "description": "Lista de endereços de e-mail da empresa."
    },
    "matriz": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a empresa é matriz."
    },
    "socios": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "nome": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome do sócio."
          },
          "cargo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cargo ou função do sócio na empresa."
          },
          "documento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Documento (CPF ou CNPJ) do sócio."
          },
          "dataEntrada": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de entrada do sócio na empresa no formato dd/MM/yyyy HH:mm:ss."
          },
          "percentualParticipacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Percentual de participação do sócio na empresa."
          }
        }
      },
      "description": "Lista de sócios da empresa."
    },
    "enderecos": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade federativa (estado)."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "Código de Endereçamento Postal."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro do endereço."
          },
          "cidade": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cidade do endereço."
          },
          "numero": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número do imóvel."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da rua, avenida ou logradouro."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          }
        }
      },
      "description": "Lista de endereços da empresa."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "whatsApp": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está vinculado ao WhatsApp."
          },
          "operadora": {
            "type": [
              "string",
              "null"
            ],
            "description": "Operadora de telefonia."
          },
          "tipoTelefone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de telefone (fixo, celular, etc.)."
          },
          "telefoneComDDD": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de telefone com DDD."
          },
          "telemarketingBloqueado": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indica se o telefone está bloqueado para telemarketing."
          }
        }
      },
      "description": "Lista de telefones da empresa."
    },
    "cnaeCodigo": {
      "type": [
        "number",
        "null"
      ],
      "description": "Código da Classificação Nacional das Atividades Econômicas principal."
    },
    "razaoSocial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social da empresa."
    },
    "tipoEmpresa": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tipo de constituição da empresa."
    },
    "dataFundacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de fundação da empresa no formato dd/MM/yyyy HH:mm:ss."
    },
    "nomeFantasia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome fantasia da empresa."
    },
    "orgaoPublico": {
      "type": [
        "string",
        "null"
      ],
      "description": "Órgão público relacionado à empresa, se aplicável."
    },
    "cnaeDescricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição da atividade econômica principal."
    },
    "cnaEsSecundarios": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "cnaeCodigoSecundario": {
            "type": [
              "number",
              "null"
            ],
            "description": "Código da atividade econômica secundária."
          },
          "cnaeDescricaoSecundario": {
            "type": [
              "string",
              "null"
            ],
            "description": "Descrição da atividade econômica secundária."
          }
        }
      },
      "description": "Lista de atividades econômicas secundárias."
    },
    "faixaFaturamento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa estimada de faturamento anual."
    },
    "faixaFuncionarios": {
      "type": [
        "string",
        "null"
      ],
      "description": "Faixa estimada de quantidade de funcionários."
    },
    "situacaoCadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral da empresa."
    },
    "ultimaAtualizacaoPJ": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da última atualização dos dados cadastrais."
    },
    "naturezaJuridicaTipo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tipo de natureza jurídica da empresa."
    },
    "naturezaJuridicaCodigo": {
      "type": [
        "number",
        "null"
      ],
      "description": "Código da natureza jurídica da empresa."
    },
    "quantidadeFuncionarios": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de funcionários da empresa."
    },
    "naturezaJuridicaDescricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição da natureza jurídica da empresa."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A estimativa de faturamento é calculada através de análise multivariada considerando: segmentação econômica, regime jurídico, tamanho operacional, volume de pessoal, estrutura acionária e demonstrações de capital. Este modelo permite categorizar empresas por potencial de receita para subsidiar decisões de crédito, análises de conformidade e benchmarking setorial.
>
> Listas de sócios, telefones, endereços e e-mails podem conter múltiplas registros. Campos booleanos (`matriz`, `telemarketingBloqueado`, `whatsApp`) informam presença de atributos específicos.
>
> Os dados retornados estão estruturados para integração imediata em sistemas de gestão, KYC/KYB e avaliação de risco, com respostas geradas em tempo real.

---

Página em HTML: https://fontedata.com/docs/pessoa-juridica/cadastro-pj-basica
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp