CNPJ na Receita Federal

Consulte dados cadastrais de empresas, como razão social, nome fantasia, situação cadastral, endereço, CNAEs, natureza jurídica, porte e quadro societário.

Custos

Consulta	Créditos consumidos
Consulta de um CNPJ atendida pelo cache	1 crédito
Consulta online de um CNPJ	1 crédito
Consulta de um CNPJ com `optin` dos sócios, em cache ou online	1 crédito

O custo é o total por requisição concluída sem erro. A estratégia de cache não altera esse valor. Retornos com erro não consomem créditos.

A opção optin dos sócios não acrescenta créditos: os dados ampliados estão incluídos no custo total de 1 crédito por requisição. O recurso depende de habilitação na conta; entre em contato com a equipe comercial para habilitá-lo.

Crédito é a unidade de consumo do plano. Consulte o valor dos planos e a tabela de Consumo por consulta.

Informações de entrada

Para realizar uma consulta na API CNPJ na Receita Federal, é necessário informar apenas o CNPJ. Os demais parâmetros são opcionais e permitem controlar o comportamento da consulta, especialmente o uso de cache.

CNPJ: Documento da empresa que será consultada. Pode ser enviado com ou sem pontuação, desde que completo.

Cache: Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor padrão é 7 dias.

Cache Strategy: Define o comportamento da consulta, determinando a prioridade entre dados em cache e consulta em tempo real na Receita Federal.

Optin: Quando definido como 1, solicita a exibição do CPF dos sócios no quadro societário. Essa funcionalidade requer habilitação na conta; consulte as condições com a equipe comercial.

Optin ainda não está ativo na sua conta? Fale conosco para habilitar e consultar condições.

Parâmetros obrigatórios

Name
cnpj
Type
string
Description
CNPJ completo da empresa. Pode ser informado com ou sem pontuação.
Exemplo: 15436940000103

Parâmetros opcionais

Name
cache
Type
number
Description
Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor padrão é 7 dias.
Esse parâmetro não altera sozinho a prioridade da requisição. Para priorizar cache, informe também uma estratégia compatível em cache_strategy.

Name
cache_strategy
Type
string
Description
Estratégia utilizada pela API para decidir entre reutilizar cache e consultar online na Receita Federal. O valor padrão é ONLINE_PREFERENCIAL.
Valores aceitos: CACHE_SE_EXISTIR, CACHE_PREFERENCIAL, SO_ONLINE, ONLINE_PREFERENCIAL.

Name
optin
Type
string
Description
Quando definido como 1, solicita a exibição do CPF dos sócios no quadro societário. Use 0 para desativar (padrão).
Essa funcionalidade requer habilitação prévia na conta e não acrescenta créditos ao custo da consulta. Consulte a disponibilidade com a equipe comercial.
Optin ainda não está ativo na sua conta? Fale conosco para habilitar e consultar condições.

Estratégias de Cache

A API oferece diferentes estratégias para balancear entre disponibilidade, latência e atualização dos dados:

Estratégia	Prioridade	Fallback	Descrição
`CACHE_SE_EXISTIR`	Cache	Online	Utiliza o cache caso exista resultado armazenado para o CNPJ. Em cache miss, tenta consulta em tempo real na Receita Federal.
`CACHE_PREFERENCIAL`	Cache válido	Online	Utiliza o cache quando estiver dentro da validade definida por `cache`. Caso contrário, tenta consulta em tempo real na Receita Federal.
`SO_ONLINE`	Online	Exceção por créditos do fornecedor	Usa a modalidade online. Se o fornecedor informar explicitamente falta de créditos, pode retornar o cadastro offline existente. Outros erros não habilitam esse fallback.
`ONLINE_PREFERENCIAL`	Cache válido / online	Exceção por créditos do fornecedor	Reutiliza cadastro dentro da janela de `cache`; quando ausente ou vencido, tenta online. Padrão.

Continuidade quando faltam créditos no fornecedor

Se uma tentativa online receber uma resposta explícita de falta de créditos do fornecedor, a API pode concluir a consulta com o cadastro da base offline, inclusive em SO_ONLINE. Essa exceção aceita o cadastro do mesmo CNPJ independentemente da idade, mesmo sem data de atualização conhecida. O parâmetro cache não limita a idade nesse fallback; os dados não devem ser tratados como recém-consultados.

Um 429 genérico ou por limite de requisições, timeout, erro de autenticação, “não encontrado” e demais falhas não acionam essa exceção. Se não houver cadastro offline utilizável, a falha técnica permanece: ela não é convertida em “CNPJ inexistente”. O fallback não atualiza a data dos dados nem gera uma segunda tentativa online.

A consulta concluída com cadastro offline continua custando 1 crédito, uma única vez, respeitando as isenções existentes. Falha técnica não consome crédito. Saldo insuficiente do cliente na Sintegrapi continua bloqueando a consulta com 402; não é a mesma situação que falta de créditos no fornecedor.

Identificação da modalidade no JSON

Campo	Tipo	Significado
`is_cache`	`boolean`	Na raiz da resposta com cadastro utilizável: `true` identifica dados da base offline, tanto no uso normal quanto no fallback; `false` identifica a modalidade online.

O campo não fica dentro de response e é omitido em erros e retornos sem cadastro. Ele não representa o cache HTTP interno (Redis): a modalidade online pode reutilizar essa camada e continuar retornando is_cache: false. Portanto, false não comprova uma nova chamada ao fornecedor nem uma atualização naquele instante.

Exemplo ilustrativo e reduzido de cadastro entregue pela base offline:

Trecho de resposta com cadastro offline

{
  "request_id": "11111111-1111-4111-8111-111111111111",
  "success": true,
  "error": false,
  "is_cache": true,
  "response": {
    "cnpj": "11222333000181",
    "nome_empresarial": "EMPRESA FICTICIA",
    "nome_fantasia": null,
    "data_da_situacao_especial": null
  }
}

Na modalidade online, esse mesmo campo vem como "is_cache": false.

GET/consultas/v2/cnpj-receita-federal/{cnpj}

Receita Federal PJ

Esse endpoint retorna dados cadastrais de CNPJ, aplicando a estratégia configurada entre a base offline e a modalidade online.

Parâmetros de query string

Name
cache
Type
number
Description
Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor default é 7 dias.

Name
cache_strategy
Type
string
Description
Estratégia de cache a ser utilizada. O valor default é ONLINE_PREFERENCIAL.
Valores aceitos: CACHE_SE_EXISTIR, CACHE_PREFERENCIAL, SO_ONLINE, ONLINE_PREFERENCIAL.

Name
optin
Type
string
Description
Quando definido como 1, solicita a exibição do CPF dos sócios no quadro societário. Requer habilitação na conta; consulte as condições com a equipe comercial.

Requisição

GET

/consultas/v2/cnpj-receita-federal/{cnpj}

curl "https://api.sintegrapi.com.br/consultas/v2/cnpj-receita-federal/15436940000103" \
  -H "x-api-key: SUA_API_KEY"

Resposta resumida — exemplo na modalidade online

{
    "request_id": "326dd48e-4039-4e27-b339-33ad3bedbefa",
    "success": true,
    "error": false,
    "is_cache": false,
    "response": {
        "cnpj": "15436940000103",
        "identificador_matriz_filial": "Matriz",
        "data_de_abertura": "2012-04-02",
        "nome_empresarial": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
        "nome_fantasia": "Amazon.Com.Br",
        "data_da_situacao_especial": null,
        "situacao_cadastral": "Ativa",
        "data_da_situacao_cadastral": "2012-04-02",
        "porte": "DEMAIS",
        "natureza_juridica": {
            "codigo": "2062",
            "descricao": "Sociedade Empresária Limitada"
        },
        "atividade_economica_principal": {
            "codigo": "4761001",
            "descricao": "Comércio varejista de livros"
        },
        "logradouro": "Avenida Pres Juscelino Kubitschek",
        "numero": "2041",
        "bairro": "Vila Nova Conceicao",
        "cep": "04543011",
        "municipio": "São Paulo",
        "uf": "SP",
        "telefone": "1141302000",
        "endereco_eletronico": "amzbr-tax-compliance@amazon.com"
    }
}

Ver exemplo de resposta completo mais abaixo.

Exemplos de Uso

Consulta padrão (valores padrão)

GET /consultas/v2/cnpj-receita-federal/15436940000103

Equivalente a:

GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=ONLINE_PREFERENCIAL&cache=7

Consulta priorizando cache por 30 dias

GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=CACHE_PREFERENCIAL&cache=30

A API utilizará o cache se ele tiver até 30 dias de idade. Caso contrário, tentará uma nova consulta em tempo real na Receita Federal.

Consulta reutilizando qualquer cache existente

GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=CACHE_SE_EXISTIR

Se houver cache para o CNPJ, ele será retornado sem validação de idade. Em cache miss, a API tentará a consulta em tempo real na Receita Federal.

Consulta na modalidade online

GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=SO_ONLINE

A API usa a modalidade online, que pode reutilizar seu cache HTTP interno. A única exceção de fallback para a base offline ocorre quando o fornecedor informa explicitamente falta de créditos. Nesse caso, um cadastro utilizável do mesmo CNPJ pode ser entregue com is_cache: true, sem limite de idade.

Consulta com a estratégia padrão

GET /consultas/v2/cnpj-receita-federal/15436940000103?cache_strategy=ONLINE_PREFERENCIAL&cache=7

A API reutiliza o cadastro local se ele estiver dentro da janela de sete dias. Caso contrário, tenta a modalidade online. Se essa tentativa falhar especificamente por falta de créditos do fornecedor, poderá utilizar o cadastro offline existente, mesmo vencido ou sem data conhecida.

Consulta com dados ampliados de sócios

GET /consultas/v2/cnpj-receita-federal/15436940000103?optin=socios_detalhados

Quando a conta possui o recurso habilitado, a resposta pode incluir dados ampliados do quadro societário. O custo total permanece em 1 crédito, conforme a seção Custos.

Observações Importantes

O parâmetro cache não força a criação de um novo cache. Ele define apenas a idade máxima aceita para considerar um cache válido em estratégias aplicáveis.
O valor padrão de cache_strategy é ONLINE_PREFERENCIAL; um cadastro dentro da janela de cache pode atender a consulta sem nova tentativa online.
O fallback por falta de créditos do fornecedor depende de cadastro offline utilizável do mesmo CNPJ e aceita qualquer idade.
Em SO_ONLINE, somente essa falta de créditos explicitamente identificada habilita o fallback offline; os demais erros preservam o comportamento anterior.
Em CACHE_PREFERENCIAL, se o cache estiver expirado, sem data válida ou inexistente, a API tenta consulta em tempo real na Receita Federal.
Em CACHE_SE_EXISTIR, qualquer cache armazenado pode ser reutilizado, independentemente da idade.
Após resposta online válida, os dados do CNPJ são atualizados no cache. Respostas incompletas, erros e timeouts não devem atualizar o cache.

Exemplo de resposta

Exemplo ilustrativo na modalidade online (is_cache: false):

{
    "request_id": "a0741b74-4052-46ce-9721-8006669a8d7f",
    "success": true,
    "error": false,
    "is_cache": false,
    "response": {
        "cnpj": "15436940000103",
        "identificador_matriz_filial": "Matriz",
        "data_de_abertura": "2012-04-02",
        "nome_empresarial": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
        "nome_fantasia": "Amazon.Com.Br",
        "atividade_economica_principal": {
            "codigo": "4761001",
            "descricao": "Comércio varejista de livros"
        },
        "atividades_economicas_secundarias": [
            {
                "codigo": "4530703",
                "descricao": "Comércio a varejo de peças e acessórios novos para veículos automotores"
            },
            {
                "codigo": "4530705",
                "descricao": "Comércio a varejo de pneumáticos e câmaras-de-ar"
            },
            {
                "codigo": "4541206",
                "descricao": "Comércio a varejo de peças e acessórios novos para motocicletas e motonetas"
            },
            {
                "codigo": "4713004",
                "descricao": "Lojas de departamentos ou magazines, exceto lojas francas (Duty free)"
            },
            {
                "codigo": "4721104",
                "descricao": "Comércio varejista de doces, balas, bombons e semelhantes"
            },
            {
                "codigo": "4723700",
                "descricao": "Comércio varejista de bebidas"
            },
            {
                "codigo": "4729699",
                "descricao": "Comércio varejista de produtos alimentícios em geral ou especializado em produtos alimentícios não especificados anteriormente"
            },
            {
                "codigo": "4732600",
                "descricao": "Comércio varejista de lubrificantes"
            },
            {
                "codigo": "4744001",
                "descricao": "Comércio varejista de ferragens e ferramentas"
            },
            {
                "codigo": "4751201",
                "descricao": "Comércio varejista especializado de equipamentos e suprimentos de informática"
            },
            {
                "codigo": "4752100",
                "descricao": "Comércio varejista especializado de equipamentos de telefonia e comunicação"
            },
            {
                "codigo": "4753900",
                "descricao": "Comércio varejista especializado de eletrodomésticos e equipamentos de áudio e vídeo"
            },
            {
                "codigo": "4754701",
                "descricao": "Comércio varejista de móveis"
            },
            {
                "codigo": "4755503",
                "descricao": "Comercio varejista de artigos de cama, mesa e banho"
            },
            {
                "codigo": "4759899",
                "descricao": "Comércio varejista de outros artigos de uso doméstico não especificados anteriormente"
            },
            {
                "codigo": "4761003",
                "descricao": "Comércio varejista de artigos de papelaria"
            },
            {
                "codigo": "4763601",
                "descricao": "Comércio varejista de brinquedos e artigos recreativos"
            },
            {
                "codigo": "4763603",
                "descricao": "Comércio varejista de bicicletas e triciclos; peças e acessórios"
            },
            {
                "codigo": "4771704",
                "descricao": "Comércio varejista de medicamentos veterinários"
            },
            {
                "codigo": "4772500",
                "descricao": "Comércio varejista de cosméticos, produtos de perfumaria e de higiene pessoal"
            },
            {
                "codigo": "4773300",
                "descricao": "Comércio varejista de artigos médicos e ortopédicos"
            },
            {
                "codigo": "4774100",
                "descricao": "Comércio varejista de artigos de óptica"
            },
            {
                "codigo": "4789002",
                "descricao": "Comércio varejista de plantas e flores naturais"
            },
            {
                "codigo": "4789004",
                "descricao": "Comércio varejista de animais vivos e de artigos e alimentos para animais de estimação"
            },
            {
                "codigo": "4789005",
                "descricao": "Comércio varejista de produtos saneantes domissanitários"
            },
            {
                "codigo": "4789007",
                "descricao": "Comércio varejista de equipamentos para escritório"
            },
            {
                "codigo": "4789099",
                "descricao": "Comércio varejista de outros produtos não especificados anteriormente"
            },
            {
                "codigo": "5211799",
                "descricao": "Depósitos de mercadorias para terceiros, exceto armazéns gerais e guarda-móveis"
            },
            {
                "codigo": "5811500",
                "descricao": "Edição de livros"
            },
            {
                "codigo": "5911101",
                "descricao": "Estúdios cinematográficos"
            },
            {
                "codigo": "5911199",
                "descricao": "Atividades de produção cinematográfica, de vídeos e de programas de televisão não especificadas anteriormente"
            },
            {
                "codigo": "5913800",
                "descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
            },
            {
                "codigo": "6202300",
                "descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis"
            },
            {
                "codigo": "6203100",
                "descricao": "Desenvolvimento e licenciamento de programas de computador não customizáveis"
            },
            {
                "codigo": "6204000",
                "descricao": "Consultoria em tecnologia da informação"
            },
            {
                "codigo": "6311900",
                "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet"
            },
            {
                "codigo": "6319400",
                "descricao": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
            },
            {
                "codigo": "6499999",
                "descricao": "Outras atividades de serviços financeiros não especificadas anteriormente"
            },
            {
                "codigo": "6619399",
                "descricao": "Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente"
            },
            {
                "codigo": "7319002",
                "descricao": "Promoção de vendas"
            },
            {
                "codigo": "7319004",
                "descricao": "Consultoria em publicidade"
            },
            {
                "codigo": "7319099",
                "descricao": "Outras atividades de publicidade não especificadas anteriormente"
            },
            {
                "codigo": "7490104",
                "descricao": "Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários"
            },
            {
                "codigo": "8211300",
                "descricao": "Serviços combinados de escritório e apoio administrativo"
            },
            {
                "codigo": "8220200",
                "descricao": "Atividades de teleatendimento"
            },
            {
                "codigo": "8291100",
                "descricao": "Atividades de cobrança e informações cadastrais"
            },
            {
                "codigo": "8299799",
                "descricao": "Outras atividades de serviços prestados principalmente às empresas não especificadas anteriormente"
            }
        ],
        "natureza_juridica": {
            "codigo": "2062",
            "descricao": "Sociedade Empresária Limitada"
        },
        "tipo_logradouro": null,
        "logradouro": "Avenida Pres Juscelino Kubitschek",
        "numero": "2041",
        "bairro": "Vila Nova Conceicao",
        "complemento": "Andar Rec5 6 8 9 10 12AO23PAVMTOANDAR 17 Parte",
        "cep": "04543011",
        "municipio": "São Paulo",
        "uf": "SP",
        "endereco_eletronico": "amzbr-tax-compliance@amazon.com",
        "telefone": "1141302000",
        "situacao_cadastral": "Ativa",
        "data_da_situacao_cadastral": "2012-04-02",
        "situacao_especial": null,
        "data_da_situacao_especial": null,
        "ente_federativo_responsavel": null,
        "porte": "DEMAIS",
        "socios": [
            {
                "nome": "Ricardo Jose Thomaz Pagani",
                "cpf_cnpj_socio": "123456789101",
                "qualificacao_socio": "Administrador",
                "data_entrada_sociedade": "2017-08-10 00:00:00",
                "pais": null,
                "documento_representante_legal": null,
                "nome_representante_legal": null,
                "faixa_etaria": "61-70"
            },
            {
                "nome": "Juliana Soibelmann Sztrajtman",
                "cpf_cnpj_socio": "123456789101",
                "qualificacao_socio": "Administrador",
                "data_entrada_sociedade": "2025-02-13 00:00:00",
                "pais": null,
                "documento_representante_legal": null,
                "nome_representante_legal": null,
                "faixa_etaria": "41-50"
            },
            {
                "nome": "RAINFOREST HOLDCO 1 LLC",
                "cpf_cnpj_socio": "28886481000101",
                "qualificacao_socio": "Sócio Pessoa Jurídica Domiciliado no Exterior",
                "data_entrada_sociedade": "2017-11-30 00:00:00",
                "pais": null,
                "faixa_etaria": null,
                "documento_representante_legal": "***747448**",
                "nome_representante_legal": "Fernando Gentil Monteiro"
            }
        ]
    }
}

Campos sem informação disponível podem ser retornados como null, string vazia ou coleção vazia, conforme o campo do contrato.

Códigos HTTP comuns

Código	Significado
`200`	Requisição processada. Consulte `success`, `error` e `error_message` no corpo da resposta.
`400`	CNPJ inválido, estratégia inválida ou falha ao processar a consulta.
`401`	Chave de API ausente ou inválida.
`402`	Saldo insuficiente para realizar a consulta.
`429`	Limite de requisições excedido.
`500`	Erro interno inesperado.

Consulte também a página de erros da API para orientações gerais de tratamento.

Boas práticas

Defina uma janela de cache adequada ao seu processo e verifique is_cache antes de atualizar cadastros sensíveis ao frescor.
SO_ONLINE não garante ausência de cache: mantém o cache HTTP interno e permite a exceção offline por falta de créditos do fornecedor.
Para reduzir latência em rotinas menos sensíveis à atualização, utilize CACHE_PREFERENCIAL com uma validade adequada ao seu processo.
Não envie cache esperando que ele, isoladamente, altere a prioridade da consulta; defina também cache_strategy quando quiser priorizar cache.
Trate timeouts e erros transitórios com retentativas controladas e backoff exponencial.
Não presuma que uma falha online sempre terá fallback: a causa precisa ser falta de créditos explicitamente identificada, e o cadastro offline deve existir para o CNPJ consultado.

Integração com CRMs e ERPs

Use a API de CNPJ na Receita Federal para preencher e revisar cadastros empresariais a partir do documento informado pelo cliente ou fornecedor. A conexão com o ERP ou CRM é feita por requisições HTTPS autenticadas e mapeamento dos dados da resposta.

Cadastro de CNPJ no TOTVS Protheus, SAP Business One e Omie

Para integrar a consulta de CNPJ ao TOTVS Protheus, TOTVS RM, SAP S/4HANA, SAP Business One, Sankhya, Omie ou Bling, associe a empresa pelo CNPJ e mapeie os dados contidos em response. A implementação deve respeitar os campos, as permissões e as APIs disponíveis na versão contratada do ERP.

Campo da resposta	Uso na integração
`response.cnpj`	Identificar a empresa e evitar cadastros duplicados.
`response.nome_empresarial` e `response.nome_fantasia`	Preencher a identificação do cliente ou fornecedor.
`response.atividade_economica_principal` e `response.atividades_economicas_secundarias`	Registrar CNAEs para classificação comercial e cadastral.
`response.logradouro`, `response.municipio`, `response.uf` e `response.cep`	Compor o endereço cadastral.
`response.situacao_cadastral` e `response.socios`	Apoiar a revisão cadastral e do quadro societário.

Enriquecimento de empresas no Salesforce, HubSpot e Pipedrive

No Salesforce, Microsoft Dynamics 365, HubSpot, Pipedrive ou Zoho CRM, a consulta pode compor um fluxo de enriquecimento de contas, segmentação por atividade e qualificação de fornecedores. Use o CNPJ como referência para conciliação e defina quais campos a integração pode sobrescrever.

Os dados ampliados dos sócios dependem da habilitação de optin e estão incluídos no custo de 1 crédito por consulta. Execute a chamada no servidor, preserve request_id e valide o conteúdo de response antes da atualização. O JSON Schema da resposta descreve os campos e suas estruturas.

JSON Schema da Resposta

O schema usa JSON Schema Draft 2020-12. Quando há um cadastro em response, seus campos sem informação são retornados explicitamente como null, tanto em consultas online quanto em consultas ao cache. Textos vazios ou compostos somente por espaços são normalizados para null, inclusive nos dados dos sócios. Listas vazias permanecem []. As datas de abertura, situação cadastral e situação especial são null quando ausentes ou representadas na origem por 0001-01-01; a API não cria uma data 1900-01-01 para substituí-las. Datas reais são preservadas em YYYY-MM-DD.

Por exemplo, uma empresa sem nome fantasia nem data de situação especial contém:

Trecho de response com dados ausentes

{
  "nome_fantasia": null,
  "data_da_situacao_especial": null
}

Essa regra se aplica à rota /consultas/v2/cnpj-receita-federal/{cnpj}. O envelope mantém seu comportamento: error_message pode ser omitido e, em erros ou ausência de cadastro, response pode ser omitido. O novo is_cache é booleano quando há cadastro utilizável e é omitido nos demais casos; permanece opcional no schema para compatibilidade com respostas anteriores. Integrações que tratavam "" devem aceitar null. Valide também success e error antes de atualizar o cadastro. Propriedades adicionais são aceitas para permitir evolução compatível. O schema descreve o corpo JSON; o código HTTP deve ser tratado separadamente.

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "CNPJ Receita Federal — Resposta",
  "type": "object",
  "properties": {
    "request_id": { "type": "string", "format": "uuid" },
    "success": {
      "type": "boolean",
      "description": "Resultado funcional da consulta; avalie junto com error."
    },
    "error": {
      "type": "boolean",
      "description": "Indica falha técnica ou de validação."
    },
    "is_cache": {
      "type": "boolean",
      "description": "Presente em respostas com cadastro utilizável: true para a base offline (inclusive fallback por falta de créditos do fornecedor), false para a modalidade online. Não indica hit no cache HTTP interno nem comprova atualização naquele instante."
    },
    "error_message": {
      "type": ["object", "null"],
      "properties": {
        "message": {
          "type": ["string", "null"],
          "description": "Mensagem pública da consulta."
        },
        "code": {
          "type": ["string", "null"],
          "description": "Código público, quando informado."
        }
      }
    },
    "response": {
      "type": ["object", "null"],
      "description": "Dados cadastrais retornados pela Receita Federal.",
      "required": ["nome_fantasia", "data_da_situacao_especial"],
      "properties": {
        "cnpj": {
          "type": ["string", "null"],
          "description": "CNPJ consultado, sem formatação."
        },
        "identificador_matriz_filial": {
          "type": ["string", "null"],
          "description": "Indica se o estabelecimento é a matriz ou uma filial."
        },
        "data_de_abertura": {
          "type": ["string", "null"],
          "format": "date",
          "description": "Data de abertura da empresa no formato YYYY-MM-DD."
        },
        "nome_empresarial": {
          "type": ["string", "null"],
          "description": "Razão social da empresa."
        },
        "nome_fantasia": {
          "type": ["string", "null"],
          "description": "Nome fantasia da empresa, quando informado."
        },
        "atividade_economica_principal": {
          "type": ["object", "null"],
          "description": "CNAE principal da empresa.",
          "properties": {
            "codigo": { "type": ["string", "null"], "description": "Código CNAE." },
            "descricao": {
              "type": ["string", "null"],
              "description": "Descrição da atividade econômica."
            }
          }
        },
        "atividades_economicas_secundarias": {
          "type": ["array", "null"],
          "description": "Lista de CNAEs secundários.",
          "items": {
            "type": ["object", "null"],
            "properties": {
              "codigo": { "type": ["string", "null"] },
              "descricao": { "type": ["string", "null"] }
            }
          }
        },
        "natureza_juridica": {
          "type": ["object", "null"],
          "description": "Natureza jurídica da empresa.",
          "properties": {
            "codigo": {
              "type": ["string", "null"],
              "description": "Código da natureza jurídica."
            },
            "descricao": {
              "type": ["string", "null"],
              "description": "Descrição da natureza jurídica."
            }
          }
        },
        "logradouro": {
          "type": ["string", "null"],
          "description": "Nome da rua/avenida do endereço."
        },
        "numero": { "type": ["string", "null"], "description": "Número do endereço." },
        "complemento": {
          "type": ["string", "null"],
          "description": "Complemento do endereço."
        },
        "bairro": { "type": ["string", "null"], "description": "Bairro do endereço." },
        "cep": {
          "type": ["string", "null"],
          "description": "CEP do endereço, sem formatação."
        },
        "municipio": { "type": ["string", "null"], "description": "Nome do município." },
        "uf": { "type": ["string", "null"], "description": "Sigla do estado (UF)." },
        "endereco_eletronico": {
          "type": ["string", "null"],
          "description": "E-mail de contato da empresa, quando disponível."
        },
        "telefone": {
          "type": ["string", "null"],
          "description": "Telefone de contato, quando disponível."
        },
        "situacao_cadastral": {
          "type": ["string", "null"],
          "description": "Situação cadastral atual (ex: ATIVA, BAIXADA, SUSPENSA)."
        },
        "data_da_situacao_cadastral": {
          "type": ["string", "null"],
          "format": "date",
          "description": "Data da última atualização da situação cadastral."
        },
        "porte": {
          "type": ["string", "null"],
          "description": "Porte da empresa (ex: MICRO EMPRESA, EMPRESA DE PEQUENO PORTE, DEMAIS)."
        },
        "socios": {
          "type": ["array", "null"],
          "items": {
            "type": ["object", "null"],
            "properties": {
              "nome": { "type": ["string", "null"] },
              "cpf_cnpj_socio": { "type": ["string", "null"] },
              "qualificacao_socio": { "type": ["string", "null"] },
              "pais": { "type": ["string", "null"] },
              "documento_representante_legal": { "type": ["string", "null"] },
              "nome_representante_legal": { "type": ["string", "null"] },
              "faixa_etaria": { "type": ["string", "null"] },
              "data_entrada_sociedade": {
                "type": ["string", "null"],
                "description": "Data e hora no formato YYYY-MM-DD HH:mm:ss.",
                "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
              }
            }
          }
        },
        "tipo_logradouro": { "type": ["string", "null"] },
        "ente_federativo_responsavel": { "type": ["string", "null"] },
        "situacao_especial": { "type": ["string", "null"] },
        "data_da_situacao_especial": {
          "type": ["string", "null"],
          "description": "Data civil no formato YYYY-MM-DD.",
          "format": "date"
        }
      }
    }
  },
  "required": ["request_id", "success", "error"],
  "additionalProperties": true
}