Proprietários e imobiliárias podem consultar o CPF de candidatos a inquilino gratuitamente usando a API da CPFHub.io — sem cartão de crédito, com até 50 consultas por mês no plano gratuito. A verificação retorna nome completo e data de nascimento vinculados ao CPF em aproximadamente 900ms, permitindo comparar os dados com o documento apresentado antes de assinar qualquer contrato. A Lei do Inquilinato (Lei 8.245/91) permite ao locador exigir comprovação de dados do locatário, e essa consulta se enquadra na diligência normal do processo de locação.
Alugar um imóvel envolve confiança -- e a confiança começa pela verificação de dados. Quando um proprietário ou imobiliária aceita um inquilino sem confirmar que o CPF informado é real e que o nome corresponde ao documento apresentado, está assumindo um risco desnecessário. Fraudes em locações residenciais e comerciais são mais comuns do que se imagina, e a prevenção começa com uma consulta simples.
Com a CPFHub.io
Riscos de não validar o CPF do inquilino
Fraude de identidade
Golpistas apresentam documentos falsos ou de terceiros para firmar contratos de locação. Uma vez instalados no imóvel, a situação se complica -- despejo é um processo judicial demorado e custoso.
Dados inconsistentes no contrato
Um contrato assinado com nome ou CPF incorreto pode ter sua validade questionada juridicamente. Isso enfraquece a posição do proprietário em caso de inadimplência ou disputa.
Dificuldade de cobrança
Se o inquilino se torna inadimplente e os dados no contrato estão errados, a cobrança judicial fica comprometida. Não é possível protestar ou negativar alguém com dados inconsistentes.
Como funciona a validação
A consulta retorna o nome completo e a data de nascimento vinculados ao CPF. O proprietário ou corretor compara esses dados com o documento de identidade apresentado pelo candidato:
curl -X GET "https://api.cpfhub.io/cpf/12345678900" \
-H "x-api-key: SUA_CHAVE_GRATUITA" \
-H "Accept: application/json" \
--connect-timeout 10 \
--max-time 30
Resposta:
{
"success": true,
"data": {
"cpf": "12345678900",
"name": "Fernanda Costa Oliveira",
"nameUpper": "FERNANDA COSTA OLIVEIRA",
"gender": "F",
"birthDate": "1991-02-28",
"day": "28",
"month": "02",
"year": "1991"
}
}
Se a candidata apresentou RG e CPF no nome de "Fernanda Costa Oliveira" com nascimento em 28/02/1991, os dados conferem. Se houver qualquer divergência, é um sinal de alerta que merece investigação.
Fluxo de validação para proprietários
Para proprietários que alugam diretamente
- Receba o CPF do candidato durante a visita ao imóvel ou por mensagem.
- Consulte o CPF usando o cURL acima ou o script abaixo.
- Compare os dados com o documento de identidade apresentado.
- Registre a verificação como parte da documentação do processo de locação.
Script de validação
import requests
API_KEY = "SUA_CHAVE_GRATUITA"
TIMEOUT = 30
def validar_inquilino(cpf: str, nome_declarado: str, nascimento_declarado: str) -> dict:
"""
Valida dados do candidato a inquilino contra o CPF informado.
Args:
cpf: CPF do candidato (com ou sem formatação)
nome_declarado: nome informado pelo candidato
nascimento_declarado: data de nascimento declarada (DD/MM/AAAA)
Returns:
Resultado da validação
"""
cpf_limpo = cpf.replace(".", "").replace("-", "").strip()
try:
response = requests.get(
f"https://api.cpfhub.io/cpf/{cpf_limpo}",
headers={
"x-api-key": API_KEY,
"Accept": "application/json"
},
timeout=TIMEOUT
)
response.raise_for_status()
dados = response.json()
if not dados.get("success"):
return {
"aprovado": False,
"motivo": "CPF nao encontrado na base de dados"
}
nome_api = dados["data"]["nameUpper"]
nascimento_api = dados["data"]["birthDate"]
# Converter DD/MM/AAAA para AAAA-MM-DD
partes = nascimento_declarado.split("/")
if len(partes) == 3:
nascimento_formatado = f"{partes[2]}-{partes[1]}-{partes[0]}"
else:
nascimento_formatado = nascimento_declarado
nome_confere = nome_declarado.upper().strip() == nome_api
nascimento_confere = nascimento_formatado == nascimento_api
if nome_confere and nascimento_confere:
return {
"aprovado": True,
"motivo": "Todos os dados conferem",
"nome_registrado": dados["data"]["name"]
}
divergencias = []
if not nome_confere:
divergencias.append(f"Nome: declarado='{nome_declarado}' / registrado='{dados['data']['name']}'")
if not nascimento_confere:
divergencias.append(f"Nascimento: declarado='{nascimento_declarado}' / registrado='{nascimento_api}'")
return {
"aprovado": False,
"motivo": "Divergencias encontradas: " + "; ".join(divergencias)
}
except requests.exceptions.Timeout:
return {"aprovado": None, "motivo": "Timeout na consulta. Tente novamente."}
except requests.exceptions.RequestException as e:
return {"aprovado": None, "motivo": f"Erro: {e}"}
# Uso
resultado = validar_inquilino(
cpf="123.456.789-00",
nome_declarado="Fernanda Costa Oliveira",
nascimento_declarado="28/02/1991"
)
print(f"Aprovado: {resultado['aprovado']}")
print(f"Motivo: {resultado['motivo']}")
Fluxo de validação para imobiliárias
Imobiliárias processam mais candidatos e podem automatizar a validação:
Integração com sistema de gestão
def processar_ficha_cadastral(ficha: dict) -> dict:
"""
Processa ficha cadastral do candidato a inquilino.
Integra com o sistema de gestão da imobiliária.
"""
resultado_validacao = validar_inquilino(
cpf=ficha["cpf"],
nome_declarado=ficha["nome_completo"],
nascimento_declarado=ficha["data_nascimento"]
)
ficha_processada = {
"candidato": ficha["nome_completo"],
"imovel_ref": ficha.get("imovel_referencia", ""),
"cpf_valido": resultado_validacao["aprovado"],
"observacao_validacao": resultado_validacao["motivo"],
"status": "aprovado" if resultado_validacao["aprovado"] else "pendente_analise"
}
return ficha_processada
# Exemplo
ficha = {
"nome_completo": "Fernanda Costa Oliveira",
"cpf": "123.456.789-00",
"data_nascimento": "28/02/1991",
"imovel_referencia": "APT-302-B"
}
resultado = processar_ficha_cadastral(ficha)
print(f"Status: {resultado['status']}")
O que fazer quando há divergência
Nem toda divergência significa fraude. Antes de rejeitar um candidato, considere:
Divergências legítimas
- Nome social: pessoas trans podem ter nome social diferente do registrado no CPF.
- Atualização pendente: casamento ou divórcio recente pode não estar refletido ainda.
- Erro de digitação: o candidato errou um dígito ao informar o CPF.
Como proceder
- Informe o candidato sobre a divergência encontrada.
- Solicite documentação complementar (certidão de casamento, comprovante de alteração de nome).
- Peça que o candidato confira o CPF informado.
- Registre toda a comunicação para fins de documentação.
Aspectos legais da consulta
Lei do Inquilinato (Lei 8.245/91)
A lei permite ao locador exigir garantias e comprovação de dados do locatário. A verificação do CPF se enquadra na diligência normal do processo de locação.
LGPD
A consulta de CPF para fins de locação pode se enquadrar na base legal de "execução de contrato" ou "legítimo interesse". A CPFHub.io
Boas práticas
- Informe o candidato de que a verificação será realizada.
- Use os dados apenas para a finalidade de validação.
- Não armazene dados além do necessário.
Custo zero para proprietários individuais
O plano Gratuito com 50 consultas por mês é mais do que suficiente para proprietários individuais:
| Perfil | Consultas estimadas/mês | Plano |
|---|---|---|
| Proprietário (1-2 imóveis) | 2-5 | Gratuito |
| Proprietário (3-10 imóveis) | 5-15 | Gratuito |
| Pequena imobiliária | 20-50 | Gratuito |
| Imobiliária média | 100-500 | Pro |
| Imobiliária grande | 500+ | Corporativo |
Perguntas frequentes
Um proprietário sem experiência técnica consegue usar a API para validar inquilinos?
Sim. A CPFHub.io disponibiliza uma interface de consulta simples no painel, além da API. Para quem prefere o caminho técnico, o endpoint é uma chamada GET com o CPF na URL e a API key no cabeçalho — a documentação tem exemplos prontos em Python, cURL e outras linguagens. A maioria dos proprietários consegue fazer a primeira consulta em menos de 10 minutos.
Quantas consultas um proprietário com dois imóveis vai usar por mês?
Em média, dois a cinco consultas mensais — bem dentro do limite de 50 do plano gratuito. Cada candidato a inquilino gera uma consulta; imobiliárias maiores que processam dezenas de fichas por mês podem precisar do plano Pro (R$149/mês, 1.000 consultas), mas proprietários individuais raramente ultrapassam o gratuito.
A validação de CPF substitui a análise de crédito do inquilino?
Não. A consulta de CPF confirma identidade — que o candidato é quem diz ser e que os dados batem com o documento. A análise de crédito (Serasa, histórico de pagamentos, renda) é um passo separado e complementar. O ideal é fazer os dois: primeiro valide a identidade, depois avalie o perfil financeiro.
O que acontece se o nome do inquilino tiver acento ou abreviação diferente do cadastro da Receita Federal?
A API retorna o nome exatamente como consta no CPF. Pequenas diferenças de grafia (acento faltando, abreviação de sobrenome) merecem investigação, mas nem sempre indicam fraude. Oriente o candidato a conferir o CPF informado e, se necessário, solicite comprovante de situação cadastral emitido diretamente na Receita Federal.
Conclusão
Validar o CPF do inquilino antes de assinar o contrato de locação é uma medida preventiva simples que protege o proprietário contra fraudes, fortalece a validade jurídica do contrato e facilita eventuais cobranças futuras. Com o plano Gratuito da CPFHub.io
Cadastre-se em cpfhub.io
CPFHub.io
Pronto para integrar a API?
50 consultas gratuitas para testar agora. Sem cartão de crédito. Acesso imediato à documentação.
Sobre a redação
Redação CPFHub.io
Time editorial especializado em APIs de CPF, identidade digital e compliance no mercado brasileiro. Produzimos guias técnicos, análises regulatórias e tutoriais sobre LGPD e KYC para desenvolvedores e líderes de produto.



