API Receita Federal para consultar CPF e CNPJ em tempo real
Na CPF.CNPJ, nós simplificamos e agilizamos o acesso a informações essenciais de pessoas físicas e jurídicas.
O desafio: acessar dados da Receita Federal de forma direta e legal
A Receita Federal mantém as bases oficiais de CPF e CNPJ do Brasil, mas não disponibiliza uma API pública unificada de consulta para integração em sistemas. As alternativas comuns — formulários web com captcha, raspagem de dados (scraping) e portais com limites de uso — são frágeis, instáveis e juridicamente arriscadas para operações que precisam validar documentos em escala.
Empresas que executam KYC (Know Your Customer), KYB (Know Your Business) e processos de compliance precisam de dados confiáveis na fonte: situação cadastral do CPF, situação do CNPJ, quadro societário (QSA) e CNAE. Quando esses dados vêm de cópias desatualizadas ou de scraping sujeito a bloqueios, o resultado são onboardings travados, falsos positivos e exposição regulatória.
A CPF.CNPJ resolve isso oferecendo uma camada de API que entrega dados oficiais da Receita Federal de CPF e CNPJ de forma programática, em tempo real (D+0), sem captcha e sem scraping. Uma única integração REST cobre pessoa física e jurídica, com a confiabilidade exigida por fluxos de cadastro, crédito e antifraude.
Como a API CPF.CNPJ resolve
1. CPF e CNPJ numa única API
Uma só integração cobre os dois documentos. Para CPF, a API retorna a situação cadastral (Regular, Suspenso, Cancelado, Pendente de Regularização, Nulo, Cancelado por Multiplicidade ou Titular Falecido) e o nome oficial vinculado ao documento.
Para CNPJ, a API entrega situação cadastral (Ativa, Baixada, Inapta, Suspensa, Nula), razão social, nome fantasia, data de abertura, porte, CNAE principal e secundários, endereço e o quadro de sócios e administradores (QSA). Tudo a partir da fonte oficial da Receita Federal.
2. REST e JSON, fáceis de integrar
A API é RESTful e responde em JSON, sem dependência de SDK proprietário. Qualquer linguagem capaz de fazer uma requisição HTTP consegue consumir os dados, o que reduz o tempo de integração para minutos em fluxos de backend, ETLs e jobs em lote.
A estrutura de resposta é estável e documentada, permitindo mapear campos diretamente para o motor de decisão de KYC/KYB sem tratamentos frágeis de HTML.
3. Autenticação por token e dados em tempo real (D+0)
A autenticação é feita por token, sem necessidade de captcha, certificado digital ou data de nascimento. O token identifica a aplicação e o pacote contratado em cada requisição.
As consultas refletem o estado atual das bases da Receita Federal (D+0), garantindo que decisões de onboarding, crédito e compliance usem a situação cadastral mais recente disponível na fonte oficial.
4. Conformidade LGPD
O acesso aos dados é estruturado para uso legítimo em prevenção à fraude, validação cadastral e cumprimento de obrigações legais, com tratamento aderente à LGPD (Lei 13.709/2018).
Isso permite que instituições financeiras, fintechs, marketplaces e empresas reguladas validem CPF e CNPJ na fonte oficial sem recorrer a scraping ou a bases informais de origem duvidosa.
Como integrar
A integração é uma chamada REST autenticada por token. O exemplo abaixo consulta um CPF e um CNPJ na base oficial da Receita Federal e retorna a situação cadastral em JSON:
# Consulta de CPF na Receita Federal
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/9/00000000000"
# Consulta de CNPJ (situação, QSA, CNAE) na Receita Federal
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/6/00000000000000"
# Resposta (exemplo simplificado)
# {
# "status": 1,
# "documento": "00000000000000",
# "situacao": "ATIVA",
# "razao_social": "EMPRESA EXEMPLO LTDA",
# "abertura": "2015-03-10",
# "cnae_principal": "62.01-5-01",
# "qsa": [ { "nome": "SOCIO EXEMPLO", "qualificacao": "Sócio-Administrador" } ]
# }Para detalhes de endpoints, pacotes de consulta, códigos de situação e exemplos em outras linguagens, consulte a documentação completa em https://www.cpfcnpj.com.br/dev/.
Por que usar a API CPF.CNPJ
- Fonte oficial: Dados extraídos diretamente das bases da Receita Federal de CPF e CNPJ.
- D+0 em tempo real: Situação cadastral atualizada, refletindo o estado atual da fonte oficial.
- 99,9% de uptime: Disponibilidade pensada para fluxos críticos de onboarding e compliance.
- CPF e CNPJ numa só API: Uma única integração REST cobre pessoa física e jurídica.
