Como verificar CPF usando curl e API da Receita Federal

Verificar a validade de um CPF é uma tarefa essencial para empresas e profissionais que lidam com cadastros de clientes. Utilizar a API da Receita Federal através do comando curl é uma das formas mais diretas e eficientes de realizar essa validação, garantindo dados confiáveis e atualizados.

Pré-requisitos

• Ter o curl instalado no sistema (disponível para Linux, macOS e Windows).
• Possuir uma chave de acesso (token) para a API da Receita Federal (obtenha em https://servicos.receita.fazenda.gov.br).
• Conhecimento básico de uso do terminal ou prompt de comando.

Configurando o acesso à API

Antes de executar a consulta, é necessário configurar o cabeçalho de autorização com seu token. Substitua 'SEU_TOKEN_AQUI' pelo token obtido no portal da Receita Federal.

export TOKEN="SEU_TOKEN_AQUI"

Executando a consulta via curl

Com o token configurado, utilize o comando curl para enviar uma requisição GET à API, passando o CPF desejado. O CPF deve ser informado sem pontos ou traços.

curl -X GET \
  https://apireceita.fazenda.gov.br/v1/cpf/consulta/12345678901 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Interpretando a resposta

A API retornará um JSON com informações sobre o status do CPF. Uma resposta bem-sucedida incluirá campos como 'status', 'mensagem' e 'data'. É importante tratar possíveis erros, como CPF inválido ou token expirado.

{
  "status": "SUCCESS",
  "mensagem": "CPF consultado com sucesso",
  "data": {
    "cpf": "12345678901",
    "nome": "NOME DA PESSOA",
    "situacao": "REGULAR"
  }
}

Exemplo Prático

Automatizando consultas múltiplas

Para validar vários CPFs de uma só vez, você pode criar um script shell que lê uma lista de CPFs de um arquivo e executa a consulta para cada um, salvando os resultados em um arquivo de saída.

#!/bin/bash
INPUT_FILE="cpfs.txt"
OUTPUT_FILE="resultados.json"

while IFS= read -r cpf; do
  curl -s -X GET "https://apireceita.fazenda.gov.br/v1/cpf/consulta/$cpf" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Accept: application/json" >> "$OUTPUT_FILE"
  echo "" >> "$OUTPUT_FILE"
done < "$INPUT_FILE"

Conclusão

Com este método, você automatiza a validação de CPFs em segundos, evitando erros manuais e garantindo que seus dados estejam sempre atualizados e confiáveis. O uso do curl e da API da Receita Federal oferece uma solução robusta e eficiente para integração em sistemas e processos de validação.