CPF (Brasil) — formato, algoritmo e API

O que é CPF?

O CPF (Cadastro de Pessoas Físicas) é o número de identificação tributária pessoal do Brasil, emitido pela Receita Federal. É obrigatório em quase todas as transações formais no país.

Algoritmo de verificação

Pegar os primeiros 9 dígitos.
Multiplicar cada um por [10,9,8,7,6,5,4,3,2], somar, módulo 11.
Se resultado < 2 o primeiro dígito verificador é 0; senão 11 menos o resultado.
Repetir com os primeiros 10 dígitos e pesos [11,10,9,8,7,6,5,4,3,2] para o segundo dígito.
CPFs com todos os dígitos iguais (ex. 111.111.111-11) são inválidos mesmo que a matemática passe.

Valide com a API da Normadata

cURL

curl -X POST https://api.normadata.io/v1/validate/tax-ids \
  -H "X-API-Key: nd_your_key" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"id": "1", "value": "111.444.777-35", "country": "BR", "type": "cpf"}]}'

Resposta

JSON

{
  "results": [
    {
      "id": "1",
      "country": "BR",
      "type": "cpf",
      "valid": true,
      "normalized": "11144477735",
      "formatted": "111.444.777-35"
    }
  ]
}

O que o Normadata não valida

Uma resposta válida significa que o identificador está bem formatado e passa pelo algoritmo de dígito verificador. Não confirma nada do seguinte:

Existência — Não consultamos a Receita Federal, AFIP, SAT ou qualquer registro governamental. Um identificador válido pode não corresponder a um contribuinte registrado.
Identidade — Não confirmamos que o identificador pertença a uma pessoa ou entidade específica, nem que o titular seja real.
Status — Não confirmamos se o identificador está atualmente ativo, suspenso ou em dia com alguma autoridade.
KYC / KYB — Normadata não é um provedor KYC/KYB nem AML. Para verificação de identidade regulada você precisa de um provedor específico por país — Normadata é a camada de validação de formato que roda antes.

Leia nossa metodologia →

Perguntas frequentes

Como se valida um CPF?

A validação do CPF tem duas etapas. Primeira: multiplicar os primeiros 9 dígitos por [10,9,8,7,6,5,4,3,2], somar, módulo 11 — se resultado < 2 o primeiro verificador é 0, senão é 11 menos o resultado. Segunda: repetir com os primeiros 10 dígitos e pesos [11,10,9,8,7,6,5,4,3,2] para o segundo verificador. Além disso, CPFs com todos os dígitos iguais (111.111.111-11, etc.) são sempre inválidos.

Que tipo de entidade o CPF identifica?

O CPF (Cadastro de Pessoas Físicas) identifica exclusivamente pessoas físicas no Brasil. Para pessoas jurídicas (empresas) usa-se o CNPJ. O CPF é emitido pela Receita Federal e é obrigatório em quase todas as transações formais no país.

Por que CPFs com todos os dígitos iguais são inválidos?

000.000.000-00, 111.111.111-11 e similares passam matematicamente pelo algoritmo de verificação mas a Receita Federal os reserva explicitamente como inválidos. São comumente usados em dados de teste ou fraude, portanto qualquer validador correto deve rejeitá-los.

A Normadata valida o CPF contra a Receita Federal?

Não. A Normadata valida o formato e o algoritmo de dígitos verificadores. Não consulta a base de dados da Receita Federal. Para verificar se um CPF está registrado e ativo você precisa de um provedor com acesso regulado aos sistemas da Receita.

Como faço a chamada à API para validar um CPF?

POST /v1/validate/tax-ids com body {"items": [{"id": "1", "value": "111.444.777-35", "country": "BR", "type": "cpf"}]}. O endpoint aceita o CPF com ou sem pontos e hífens. Retorna valid: true/false e o valor normalizado como 11 dígitos sem formatação.