Como validar CPF e CNPJ por API?

Você autentica com seu token e envia o número do CPF ou CNPJ para o endpoint REST de validação. A API responde em JSON com o dígito verificador conferido (módulo 11) e a situação cadastral do documento na Receita Federal. O mesmo endpoint identifica automaticamente se o documento é um CPF ou um CNPJ.

Validar somente o dígito verificador é suficiente?

Não. O dígito verificador (módulo 11) confirma apenas que o número é formalmente bem formado, não que o documento existe ou está regular. É possível gerar CPFs e CNPJs com dígitos válidos que nunca foram emitidos. Para prevenir fraude, é necessário conferir também a situação cadastral real na fonte oficial.

A API valida CNPJ alfanumérico?

Sim. A API já suporta o novo formato de CNPJ alfanumérico, cuja emissão está prevista a partir de 2026. As letras e números da raiz e da ordem são aceitos, e os dois dígitos verificadores numéricos são calculados em módulo 11 sobre os valores ASCII dos caracteres.

A validação é feita em tempo real?

Sim. A API REST responde em JSON em tempo real, com latência média de 0,4 a 2 segundos. Isso permite validar documentos diretamente no fluxo de cadastro, checkout ou onboarding, sem prejudicar a experiência do usuário.

//Validação CPF/CNPJ

API de Validação de CPF e CNPJ

Na CPF.CNPJ, nós simplificamos e agilizamos o acesso a informações essenciais de pessoas físicas e jurídicas.

Por que validar CPF e CNPJ vai além do dígito verificador

Validar apenas o dígito verificador de um CPF ou CNPJ não é suficiente. O dígito verificador (calculado por módulo 11) confirma somente que a sequência de números é formalmente válida — ele não garante que o documento realmente existe nem que está regular. É possível gerar milhares de CPFs e CNPJs com dígitos verificadores corretos que nunca foram emitidos pela Receita Federal.

Por isso, cadastros falsos passam facilmente por validações que checam apenas a estrutura do número. Um formulário que aceita qualquer CPF com dígito válido permite que fraudadores criem contas em massa, burlem limites por cliente e contaminem a base de dados com identidades inexistentes. Para prevenção a fraude e antifraude, a única abordagem confiável é conferir a situação cadastral real do documento na fonte oficial.

A validação completa combina duas camadas: a validação formal (dígito verificador, em milissegundos, sem custo de consulta) e a conferência cadastral na Receita Federal (situação Regular, Cancelado, Suspenso, Nulo para CPF; Ativa, Baixada, Inapta, Suspensa para CNPJ). Apenas a soma das duas camadas garante que o documento existe e está apto a operar.

O que a API de Validação de CPF e CNPJ entrega

1. Validação de dígito verificador instantânea (módulo 11)

A API valida a estrutura do CPF e do CNPJ usando o algoritmo de módulo 11, o mesmo padrão definido pela Receita Federal para o cálculo dos dígitos verificadores. Essa checagem formal é instantânea e ocorre antes de qualquer consulta cadastral, descartando imediatamente números mal formados, repetidos (como 000.000.000-00) ou digitados incorretamente.

2. Conferência de situação cadastral real na Receita Federal

Além do dígito verificador, a API consulta a situação cadastral oficial do documento. Para CPF, retorna se está Regular, Suspenso, Cancelado, Pendente de Regularização ou Nulo. Para CNPJ, retorna a situação (Ativa, Baixada, Inapta, Suspensa) junto a razão social, data de abertura e demais dados cadastrais. É essa camada que diferencia um documento válido no papel de um documento realmente existente e apto.

3. Suporte a CPF e CNPJ, incluindo o CNPJ alfanumérico de 2026

A API valida tanto CPF quanto CNPJ pelo mesmo endpoint, identificando automaticamente o tipo de documento. O suporte inclui o novo formato de CNPJ alfanumérico, cuja emissão está prevista a partir de 2026: os oito primeiros caracteres da raiz e os quatro da ordem podem conter letras e números, mantendo os dois dígitos verificadores numéricos, calculados em módulo 11 sobre os valores ASCII dos caracteres.

4. Resposta REST/JSON em tempo real

A integração é feita por uma API REST que responde em JSON, pronta para ser chamada de qualquer linguagem ou plataforma. A autenticação é por token, sem captcha e sem necessidade de data de nascimento. A resposta em tempo real permite validar documentos diretamente no fluxo de cadastro, checkout ou onboarding, sem travar a experiência do usuário.

Como integrar a API de validação

A integração é direta: autentique com seu token e envie o CPF ou CNPJ para o endpoint de validação. O exemplo abaixo valida um CPF e um CNPJ via cURL e retorna a situação cadastral em JSON.

# Validar um CPF
curl -X POST "https://api.cpfcnpj.com.br/SEU_TOKEN/2/json/cpf" \
  -H "Content-Type: application/json" \
  -d '{"cpf": "00000000000"}'

# Resposta (JSON)
# {
#   "cpf": "000.000.000-00",
#   "nome": "NOME COMPLETO",
#   "situacao": "REGULAR"
# }

# Validar um CNPJ (inclui CNPJ alfanumérico)
curl -X POST "https://api.cpfcnpj.com.br/SEU_TOKEN/9/json/cnpj" \
  -H "Content-Type: application/json" \
  -d '{"cnpj": "00000000000000"}'

# Resposta (JSON)
# {
#   "cnpj": "00.000.000/0000-00",
#   "razao_social": "EMPRESA EXEMPLO LTDA",
#   "situacao_cadastral": "ATIVA",
#   "data_abertura": "2015-01-01"
# }

Os parâmetros completos, códigos de retorno e exemplos em outras linguagens estão na documentação oficial em https://www.cpfcnpj.com.br/dev/. O cadastro é gratuito e libera créditos para testes imediatos.

Por que usar a API de Validação de CPF e CNPJ

Latência baixa (0,4-2s): Validação formal em milissegundos e consulta cadastral em poucos segundos
Uptime de 99,9%: Infraestrutura monitorada para validação contínua em produção
Validação formal + cadastral: Dígito verificador (módulo 11) e situação real na Receita Federal
Cobertura CPF e CNPJ: Mesmo endpoint para CPF e CNPJ, incluindo CNPJ alfanumérico de 2026