# Receita Federal — Pessoa Jurídica (Tempo Real)

> Dados cadastrais de um CNPJ consultados AO VIVO na Receita Federal, sem cache: cada chamada vai à fonte oficial e devolve o carimbo de data e hora da consulta em `consultado_em`. Inclui situação cadastral, natureza jurídica, endereço, capital social, CNAEs e o Quadro de Sócios e Administradores (QSA) com nome e qualificação. Use quando o frescor do dado for mais importante que o tempo de resposta e o preço; para o mesmo conteúdo mais barato e mais rápido, com atualização mensal, use a consulta cadastral de CNPJ padrão.

- **Consulta:** `receita-federal-pj-live`
- **Categoria:** Receita Federal
- **Preço:** R$ 0,54 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/receita-federal-pj-live`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/receita-federal/receita-federal-pj-live

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta cadastral de CNPJ executada **ao vivo na Receita Federal a cada chamada**, sem nenhuma camada de cache. É o irmão PJ da consulta ao vivo de CPF, e existe para um caso específico: quando o dado precisa refletir o estado de agora, não o de uma cópia atualizada periodicamente.
>
> **Escolha entre esta consulta e a cadastral padrão de CNPJ:**
>
> | | Cadastral de CNPJ (padrão) | Esta consulta (ao vivo) |
> |---|---|---|
> | Origem | Base cadastral da Receita Federal | Consulta direta à Receita Federal |
> | Atualização | Ciclo mensal — o dado pode ter semanas | No momento da chamada |
> | Tempo de resposta | Sub-segundo | Alguns segundos |
> | Preço | Menor | Maior |
> | Carimbo de frescor | — | `consultado_em` |
>
> Se o seu caso tolera dado com semanas de idade (enriquecimento em lote, validação de cadastro, preenchimento de formulário), a consulta padrão entrega o mesmo conteúdo mais rápido e mais barato. Use esta aqui em decisão sensível ao instante: liberação de crédito, onboarding sob análise, reverificação de contraparte cuja situação cadastral pode ter mudado.
>
> **O teto do dado, declarado antes que você descubra sozinho:**
>
> - **O QSA vem sem documento.** A divulgação pública do quadro societário traz **apenas o nome e a qualificação** de cada sócio — não o CPF, nem mesmo mascarado. Para obter o documento completo de cada sócio e caminhar a cadeia societária, use a consulta de vínculos societários (UBO), que é um produto distinto.
> - **Não há percentual de participação.** Nenhuma fonte pública informa quanto cada sócio detém.
> - **Sociedade Anônima não expõe acionistas.** O registro cadastral de uma S.A. lista apenas diretoria e administradores. Cadeia societária completa só é rastreável em sociedades limitadas (Ltda).
> - **Esta consulta não emite comprovante.** Ela devolve **dados**, com o carimbo de quando foram lidos — não um documento com código de controle verificável em portal oficial. Se o seu processo exige um comprovante auditável, esta consulta não o substitui.

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/receita-federal-pj-live",
    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/receita-federal-pj-live");

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 da empresa a consultar. Aceita com ou sem máscara (00000000000000 ou 00.000.000/0000-00). | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> **Frescor**
>
> | Campo | Descrição |
> |-------|-----------|
> | `consultado_em` | Data e hora em que a fonte oficial foi consultada, em ISO 8601 com horário (`yyyy-MM-ddTHH:mm:ss`), fuso de Brasília. Como não há cache, este carimbo é a idade do dado: ele é sempre o instante da sua chamada. É o campo que distingue esta consulta da cadastral padrão — registre-o se precisar provar quando o dado foi obtido. |
>
> **Identificação e situação**
>
> | Campo | Descrição |
> |-------|-----------|
> | `cnpj` | CNPJ consultado, somente dígitos. |
> | `razao_social` | Razão social registrada. |
> | `nome_fantasia` | Nome fantasia, quando declarado (`null` quando não há). |
> | `matriz_filial` | `MATRIZ` ou `FILIAL`. |
> | `data_abertura` | Início de atividade, em ISO 8601 (`yyyy-MM-dd`). |
> | `situacao_cadastral` | Situação atual em texto: `ATIVA`, `BAIXADA`, `SUSPENSA`, `INAPTA` ou `NULA`. É o campo de decisão da maioria das integrações. |
> | `data_situacao_cadastral` | Desde quando a situação atual vale (`yyyy-MM-dd`). Numa baixa ou inaptidão, é a data do evento. |
> | `observacoes_situacao_cadastral` | Observação da Receita Federal sobre a situação, quando houver. Normalmente `null`. |
> | `situacao_especial` / `data_situacao_especial` | Situação especial (ex.: liquidação, intervenção) e sua data. `null` quando não há — que é o caso da grande maioria das empresas. |
>
> **Enquadramento e atividade**
>
> | Campo | Descrição |
> |-------|-----------|
> | `natureza_juridica` | Descrição da natureza jurídica, já sem o código (ex.: `Sociedade Empresária Limitada`). |
> | `codigo_natureza_juridica` | Código correspondente na tabela oficial (ex.: `2062`). |
> | `porte` | Porte declarado (`ME`, `EPP`, `DEMAIS`). Declarado pelo contribuinte, não apurado. |
> | `capital_social` | Capital social em reais, como **número** — não string formatada. |
> | `cnae_principal_codigo` / `cnae_principal_descricao` | Atividade econômica principal, já separada em código e descrição, para você não ter que fatiar string. |
> | `cnaes_secundarios` | Lista de atividades secundárias, cada item no formato `"<código> - <descrição>"`. Lista vazia quando a empresa não declara nenhuma. |
>
> **Endereço e contato**
>
> | Campo | Descrição |
> |-------|-----------|
> | `logradouro` / `numero` / `complemento` / `bairro` / `municipio` / `uf` / `cep` | Endereço cadastral. `cep` vem somente com dígitos. `complemento` pode vir `null` quando a Receita Federal não divulga o campo. |
> | `telefone` / `email` | Contato cadastrado. Frequentemente `null`: são campos que dependem de atualização voluntária do contribuinte. |
> | `ente_federativo_responsavel` | Preenchido apenas para órgãos e entidades públicas; `null` para empresas privadas. |
>
> **Quadro de Sócios e Administradores (`qsa`)**
>
> | Campo | Descrição |
> |-------|-----------|
> | `nome` | Nome do sócio ou administrador (pessoa física) ou razão social (pessoa jurídica). |
> | `qualificacao` | Papel no quadro, com o código oficial (ex.: `49-Sócio-Administrador`, `10-Diretor`, `22-Sócio`). |
> | `nome_representante_legal` / `qualificacao_representante_legal` | Representante legal do sócio, quando o sócio exige representação. `null` no caso comum. |
> | `pais_origem` | País de origem do sócio domiciliado no exterior. `null` para sócios brasileiros. |
>
> O `qsa` vem como **lista vazia** quando a natureza jurídica não publica quadro societário (empresário individual, MEI) — lista vazia é resposta válida, não erro.

### Exemplo de resposta

```json
{
  "uf": "SP",
  "cep": "13010100",
  "qsa": [
    {
      "nome": "MARIA EXEMPLO DA SILVA",
      "pais_origem": null,
      "qualificacao": "49-Sócio-Administrador",
      "nome_representante_legal": null,
      "qualificacao_representante_legal": null
    },
    {
      "nome": "JOSE EXEMPLO PEREIRA",
      "pais_origem": null,
      "qualificacao": "22-Sócio",
      "nome_representante_legal": null,
      "qualificacao_representante_legal": null
    }
  ],
  "cnpj": "99888777000100",
  "email": "contato@exemploalimentos.com.br",
  "porte": "EPP",
  "bairro": "CENTRO",
  "numero": "1200",
  "telefone": "(19) 3200-0000",
  "municipio": "CAMPINAS",
  "logradouro": "RUA EXEMPLO DAS FLORES",
  "complemento": "LOJA 2",
  "razao_social": "COMERCIO EXEMPLO DE ALIMENTOS LTDA",
  "consultado_em": "2026-08-05T14:32:14",
  "data_abertura": "2011-04-18",
  "matriz_filial": "MATRIZ",
  "nome_fantasia": "EXEMPLO ALIMENTOS",
  "capital_social": 450000,
  "cnaes_secundarios": [
    "56.11-2-03 - Lanchonetes, casas de chá, de sucos e similares",
    "10.91-1-02 - Fabricação de produtos de padaria e confeitaria"
  ],
  "natureza_juridica": "Sociedade Empresária Limitada",
  "situacao_especial": null,
  "situacao_cadastral": "ATIVA",
  "cnae_principal_codigo": "47.21-1-02",
  "data_situacao_especial": null,
  "data_situacao_cadastral": "2011-04-18",
  "cnae_principal_descricao": "Padaria e confeitaria com predominância de revenda",
  "codigo_natureza_juridica": "2062",
  "ente_federativo_responsavel": null,
  "observacoes_situacao_cadastral": null
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "uf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unidade federativa (sigla)."
    },
    "cep": {
      "type": [
        "string",
        "null"
      ],
      "description": "CEP, somente dígitos (8 posições)."
    },
    "qsa": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "nome": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome do sócio ou administrador (pessoa física) ou razão social (pessoa jurídica)."
          },
          "pais_origem": {
            "type": [
              "string",
              "null"
            ],
            "description": "País de origem do sócio, quando domiciliado no exterior."
          },
          "qualificacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qualificação no quadro, com o código da Receita Federal (ex.: 49-Sócio-Administrador)."
          },
          "nome_representante_legal": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome do representante legal do sócio, quando o sócio exige representação."
          },
          "qualificacao_representante_legal": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qualificação do representante legal, quando houver."
          }
        }
      },
      "description": "Quadro de Sócios e Administradores. SEM documento (CPF/CNPJ) — a divulgação pública do QSA traz apenas o nome. Lista vazia quando a natureza jurídica não publica quadro societário."
    },
    "cnpj": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ consultado, somente dígitos (14 posições)."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "E-mail cadastrado. Frequentemente ausente na base pública."
    },
    "porte": {
      "type": [
        "string",
        "null"
      ],
      "description": "Porte declarado (ex.: ME, EPP, DEMAIS)."
    },
    "bairro": {
      "type": [
        "string",
        "null"
      ],
      "description": "Bairro ou distrito."
    },
    "numero": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do imóvel."
    },
    "telefone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Telefone cadastrado, com DDD. Frequentemente ausente na base pública."
    },
    "municipio": {
      "type": [
        "string",
        "null"
      ],
      "description": "Município."
    },
    "logradouro": {
      "type": [
        "string",
        "null"
      ],
      "description": "Logradouro do endereço cadastral, incluindo o tipo (ex.: AV REPUBLICA DO CHILE)."
    },
    "complemento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Complemento do endereço. null quando a Receita Federal não divulga o campo."
    },
    "razao_social": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social (nome empresarial) registrado na Receita Federal."
    },
    "consultado_em": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data e hora em que esta consulta foi executada na fonte oficial, em ISO 8601 com horário (yyyy-MM-ddTHH:mm:ss), fuso de Brasília. Como este endpoint não usa cache, este carimbo é também a idade do dado."
    },
    "data_abertura": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de abertura / início de atividade, em ISO 8601 (yyyy-MM-dd)."
    },
    "matriz_filial": {
      "type": [
        "string",
        "null"
      ],
      "description": "MATRIZ ou FILIAL."
    },
    "nome_fantasia": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome fantasia (título do estabelecimento), quando declarado."
    },
    "capital_social": {
      "type": [
        "number",
        "null"
      ],
      "description": "Capital social declarado, em reais, como número (não string formatada)."
    },
    "cnaes_secundarios": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string",
        "description": "Atividade secundária no formato \"<código> - <descrição>\"."
      },
      "description": "Atividades econômicas secundárias. Lista vazia quando a empresa não declara nenhuma."
    },
    "natureza_juridica": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição da natureza jurídica, já sem o código (ex.: Sociedade Empresária Limitada)."
    },
    "situacao_especial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação especial (ex.: liquidação, intervenção), quando houver. null quando não há."
    },
    "situacao_cadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral atual, em texto (ATIVA, BAIXADA, SUSPENSA, INAPTA, NULA)."
    },
    "cnae_principal_codigo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código CNAE da atividade econômica principal, formatado (ex.: 06.00-0-01)."
    },
    "data_situacao_especial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data da situação especial, em ISO 8601 (yyyy-MM-dd). null quando não há situação especial."
    },
    "data_situacao_cadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data em que a situação cadastral atual passou a valer, em ISO 8601 (yyyy-MM-dd)."
    },
    "cnae_principal_descricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Descrição da atividade econômica principal."
    },
    "codigo_natureza_juridica": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código da natureza jurídica na tabela da Receita Federal (ex.: 2062)."
    },
    "ente_federativo_responsavel": {
      "type": [
        "string",
        "null"
      ],
      "description": "Ente federativo responsável — preenchido apenas para órgãos e entidades públicas."
    },
    "observacoes_situacao_cadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Observação da Receita Federal sobre a situação cadastral. Normalmente ausente (null)."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Parâmetros inválidos para esta consulta. | CNPJ ausente, com dígito verificador inválido ou fora do formato. Máscara é aceita (00.000.000/0000-00). Não é cobrada. |
| `401` | Chave de API ausente ou inválida. | Header X-API-Key não enviado ou não reconhecido. |
| `403` | Saldo insuficiente ou acesso negado a este endpoint. | Conta sem saldo para cobrir a consulta ou sem permissão no catálogo da marca. |
| `404` | Nenhum registro localizado para o CNPJ consultado. | O CNPJ tem dígito verificador válido mas não existe no Cadastro Nacional da Pessoa Jurídica. Resultado AUTORITATIVO (a fonte oficial afirmou a inexistência) e, por isso, COBRADO — a consulta ao vivo foi executada e faturada na origem. |
| `408` | A consulta excedeu o tempo limite. Tente novamente. | A fonte oficial não respondeu dentro do orçamento de tempo da consulta. Não é cobrada. |
| `503` | A fonte oficial está indisponível no momento. Tente novamente em alguns minutos. | Indisponibilidade ou instabilidade do sistema da Receita Federal. Não é cobrada — quando a origem não nos cobra, não cobramos você. |

## Quando usar

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - **Decisão sensível ao instante** — liberação de crédito, limite, contratação: confirmar que a empresa está `ATIVA` **agora**, e não segundo uma cópia de semanas atrás. Uma baixa ou inaptidão recente é exatamente o que uma réplica periódica ainda não reflete.
> - **Reverificação de contraparte já cadastrada** — monitorar mudança de situação cadastral, endereço ou quadro societário de clientes e fornecedores ativos, com `consultado_em` registrando a data de cada verificação para trilha de auditoria.
> - **Onboarding de PJ sob análise (KYB)** — dados cadastrais no momento da análise, combinados com a consulta de vínculos societários quando for preciso identificar beneficiário final com documento completo.
> - **Conferência pontual sobre divergência** — quando o dado da consulta cadastral padrão foi contestado ou parece desatualizado, esta consulta resolve a dúvida indo à fonte.
>
> Para volume, enriquecimento em lote ou qualquer caso que tolere dado com semanas de idade, prefira a consulta cadastral de CNPJ padrão: mesmo conteúdo, resposta sub-segundo e custo menor. Para a cadeia societária com documento completo dos sócios, use a consulta de vínculos societários (UBO).

---

Página em HTML: https://fontedata.com/docs/receita-federal/receita-federal-pj-live
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