CPF 🇧🇷

Consulta de dados de CPF brasileiro

Consultar CPF

POST/api/cpf/consultar

Consulta dados completos de um CPF brasileiro.

🔒 Apenas planos PRO e PREMIUM

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
cpf	string	Sim	Número do CPF (com ou sem formatação)

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/cpf/consultar \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "cpf": "123.456.789-00"
  }'

JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/cpf/consultar', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    cpf: '123.456.789-00'
  })
});

const data = await response.json();
console.log(data.data.nome_completo);

Resposta

json

{
  "success": true,
  "data": {
    "cpf": "123.456.789-00",
    "nome_completo": "FULANO DE TAL SILVA",
    "situacao_cadastral": "Regular",
    "data_nascimento": "01/01/1990",
    "digito_verificador": "00",
    "comprovante_emitido": "2024-01-15T10:30:00Z",
    "fonte": "Receita Federal",
    "credits_remaining": 4950
  }
}

Custo: 50 créditos por consulta

Validar CPF

POST/api/cpf/validar

Valida o formato de um CPF sem consumir créditos. Verifica se os dígitos verificadores estão corretos.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
cpf	string	Sim	Número do CPF para validação

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/cpf/validar \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "cpf": "123.456.789-00"
  }'

Resposta

json

{
  "success": true,
  "data": {
    "cpf": "123.456.789-00",
    "valido": true,
    "formatado": "123.456.789-00"
  }
}

Custo: Gratuito — sem consumo de créditos

Consulta em Lote

POST/api/cpf/batch

Consulta múltiplos CPFs de uma vez. Máximo de 10 CPFs por requisição.

🔒 Apenas plano PREMIUM

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
cpfs	string[]	Sim	Array de CPFs (máx. 10)

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/cpf/batch \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "cpfs": [
      "123.456.789-00",
      "987.654.321-00",
      "111.222.333-44"
    ]
  }'

Resposta

json

{
  "success": true,
  "message": "Consulta em lote realizada com sucesso",
  "data": {
    "results": [
      {
        "cpf": "123.456.789-00",
        "nome_completo": "FULANO DE TAL SILVA",
        "situacao_cadastral": "Regular",
        "data_nascimento": "01/01/1990",
        "status": "success"
      },
      {
        "cpf": "987.654.321-00",
        "nome_completo": "CICLANO DE TAL SOUZA",
        "situacao_cadastral": "Regular",
        "data_nascimento": "15/06/1985",
        "status": "success"
      }
    ],
    "total": 3,
    "successful": 3,
    "credits_remaining": 4850
  }
}

Custo: 50 créditos por CPF no lote

Recursos

✓
Validação de Formato
Verificação dos dígitos verificadores do CPF
✓
Nome Completo
Retorna o nome completo vinculado ao CPF
✓
Situação Cadastral
Verifica se o CPF está regular, suspenso, cancelado, etc.
✓
Data de Nascimento
Data de nascimento do titular do CPF
✓
Múltiplas Fontes
Dados obtidos via Brasil API e Receita Federal

⚠️

Limitações

• Apenas CPFs brasileiros são suportados
• A consulta completa requer plano PRO ou PREMIUM
• O endpoint batch é exclusivo para o plano PREMIUM
• Dados sujeitos à disponibilidade das fontes (Brasil API / Receita Federal)

💡

Dica

Use o endpoint /validar gratuitamente para verificar o formato do CPF antes de gastar créditos com a consulta completa.