# APIs de CPF para imobiliárias: como validar inquilinos e proprietários > Saiba como imobiliárias podem usar APIs de CPF para validar inquilinos e proprietários, prevenir fraudes e agilizar processos de locação e venda. **Publicado:** 22/03/2024 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/apis-de-cpf-para-imobiliarias-como-validar-inquilinos-e-proprietarios --- ## Introdução O mercado imobiliário brasileiro movimenta bilhões de reais por ano em transações de locação e compra e venda. Em cada uma dessas transações, a verificação da identidade das partes envolvidas -- inquilinos, proprietários, compradores e vendedores -- é uma etapa fundamental para prevenir fraudes, garantir a segurança jurídica do negócio e cumprir obrigações regulatórias. A validação de CPF via API é a forma mais eficiente de automatizar essa verificação. --- ## Os riscos de não validar CPF no mercado imobiliário ### Fraude de identidade em locação Um dos golpes mais comuns no mercado de locação é o uso de documentos falsos para alugar imóveis. O golpista se apresenta com CPF e documentos forjados, assina o contrato de locação e, após a entrega das chaves, desaparece sem pagar o aluguel ou causa danos ao imóvel. ### Golpe do falso proprietário Nesse golpe, um criminoso se passa pelo proprietário de um imóvel que está desocupado. Ele apresenta documentos falsos, firma um contrato de locação ou venda, recebe o pagamento (caução, aluguel antecipado ou sinal) e desaparece. O verdadeiro proprietário descobre o golpe quando o inquilino ou comprador tenta acessar o imóvel. ### Lavagem de dinheiro O mercado imobiliário é historicamente utilizado para lavagem de dinheiro. Transações com identidades não verificadas podem envolver a aquisição de imóveis com recursos ilícitos, expondo a imobiliária a riscos legais significativos. ### Inadimplência planejada Alguns inquilinos utilizam CPFs de terceiros para firmar contratos de locação com a intenção de não pagar. Quando a imobiliária tenta cobrar, descobre que o inquilino real é outra pessoa. --- ## A obrigação legal de verificar identidade ### Prevenção à lavagem de dinheiro A Resolução [COAF](https://www.gov.br/coaf) n. 36/2021 determina que imobiliárias e corretores de imóveis devem manter cadastro atualizado de clientes e comunicar operações suspeitas. Isso inclui a identificação com CPF de todas as partes envolvidas em transações. ### LGPD e proteção de dados A LGPD exige que imobiliárias tratem dados de CPF de forma responsável, com base legal adequada e medidas de segurança. A base legal mais comum para o tratamento de CPF em transações imobiliárias é a execução de contrato (art. 7o, V). ### Código Civil O Código Civil brasileiro exige a qualificação das partes em contratos, incluindo nome completo e CPF. Um contrato firmado com dados falsos pode ser anulado judicialmente. --- ## Cenários de uso da API de CPF em imobiliárias ### Validação de inquilinos No processo de locação, a imobiliária pode validar o CPF do candidato a inquilino para: * Confirmar que o CPF existe e está ativo. * Verificar se o nome informado corresponde ao titular do CPF. * Confirmar a data de nascimento para cross-check com documentos apresentados. ### Validação de proprietários Antes de cadastrar um imóvel para locação ou venda, a imobiliária válida o CPF do proprietário para: * Confirmar a identidade do proprietário. * Cruzar os dados com a matrícula do imóvel. * Prevenir o golpe do falso proprietário. ### Validação de fiadores Se o contrato de locação inclui fiador, a imobiliária válida o CPF do fiador para confirmar sua identidade antes de aceitá-lo como garantia. ### Validação em transações de compra e venda Em transações de compra e venda, ambas as partes (comprador e vendedor) devem ter seus CPFs validados para garantir a segurança jurídica do negócio. --- ## Implementação técnica ### Exemplo de consulta com cURL ```bash curl -X GET https://api.cpfhub.io/cpf/12345678900 \ -H "x-api-key: SUA_CHAVE_DE_API" \ -H "Accept: application/json" ``` ### Resposta da API ```json { "success": true, "data": { "cpf": "12345678900", "name": "Carolina Vieira Almeida", "nameUpper": "CAROLINA VIEIRA ALMEIDA", "gender": "F", "birthDate": "03/12/1988", "day": 3, "month": 12, "year": 1988 } } ``` ### Exemplo de validação para locação em PHP (Laravel) ```php use Illuminate\Support\Facades\Http; class ValidacaoImobiliaria { public function validarInquilino(string $cpf, string $nomeInformado): array { $response = Http::withHeaders([ 'x-api-key' => env('CPFHUB_API_KEY'), 'Accept' => 'application/json', ])->timeout(10)->get("https://api.cpfhub.io/cpf/{$cpf}"); $data = $response->json(); if (!$data['success']) { return [ 'aprovado' => false, 'motivo' => 'CPF não encontrado na base de dados', ]; } $nomeOficial = $data['data']['nameUpper']; $nomeUsuario = mb_strtoupper(trim($nomeInformado)); if ($nomeOficial !== $nomeUsuario) { return [ 'aprovado' => false, 'motivo' => 'Nome informado não corresponde ao CPF', 'nome_oficial' => $data['data']['name'], ]; } return [ 'aprovado' => true, 'nome' => $data['data']['name'], 'data_nascimento' => $data['data']['birthDate'], 'genero' => $data['data']['gender'], ]; } public function validarProprietario(string $cpf, string $nomeMatricula): array { // Mesma lógica, comparando com o nome na matrícula do imóvel return $this->validarInquilino($cpf, $nomeMatricula); } } ``` --- ## Fluxo de validação para locação O fluxo completo de validação de CPF em um processo de locação segue as seguintes etapas: ### Etapa 1: Cadastro do candidato O candidato a inquilino preenche um formulário com CPF, nome, data de nascimento e documentação. ### Etapa 2: Validação automática de CPF O sistema consulta a API da [**CPFHub.io**](https://www.cpfhub.io/) e verifica automaticamente se o CPF existe e se o nome retornado corresponde ao informado pelo candidato. ### Etapa 3: Análise de resultados | Resultado | Ação | | --- | --- | | CPF encontrado + dados conferem | Prosseguir para análise de crédito | | CPF encontrado + nome divergente | Solicitar documentação adicional | | CPF não encontrado | Bloquear processo e solicitar esclarecimentos | ### Etapa 4: Análise de crédito e referências Após a validação do CPF, o processo segue para análise de crédito, verificação de referências e demais etapas da avaliação cadastral. ### Etapa 5: Assinatura do contrato Com todos os dados validados, o contrato é firmado com segurança jurídica. --- ## Integração com sistemas imobiliários A API da CPFHub.io pode ser integrada a sistemas de gestão imobiliária (ERP), CRMs e plataformas de proptech. Com exemplos de código em mais de 13 linguagens, a integração é viável independentemente da stack tecnológica utilizada: * **PHP/Laravel** -- Para sistemas web tradicionais. * **Node.js/Express** -- Para plataformas modernas. * **Python** -- Para automações e scripts. * **Java/.NET** -- Para sistemas corporativos. --- ## Planos recomendados para imobiliárias | Plano | Preço | Consultas/mês | Ideal para | | --- | --- | --- | --- | | Grátis | R$ 0 | 50 | Imobiliárias pequenas, testes | | Pro | R$ 149/mês | 1.000 | Imobiliárias de médio porte | | Corporativo | Sob consulta | Personalizado | Redes e grandes operações | A maioria das imobiliárias de pequeno e médio porte se enquadra no plano Pro, que oferece 1.000 consultas por mês com SLA de 99%. Para redes de imobiliárias ou proptechs com alto volume de transações, o plano Corporativo oferece infraestrutura exclusiva e suporte dedicado. --- ## Boas práticas para imobiliárias * **Valide todas as partes** -- Não valide apenas o inquilino. Valide também proprietários, fiadores e compradores. * **Registre as validações** -- Mantenha logs de todas as consultas de CPF realizadas, com data, hora e resultado. Esses registros são essenciais para auditorias do COAF. * **Cruze dados com documentos** -- Use os dados retornados pela API para conferir com os documentos apresentados (RG, CNH, comprovante de endereço). * **Atualize cadastros periodicamente** -- Em contratos de locação de longo prazo, revalide os dados periodicamente. * **Proteja os dados coletados** -- Armazene CPFs e dados pessoais com criptografia e controle de acesso, em conformidade com a LGPD. --- ## Perguntas frequentes ### O que é necessário para implementar validação de CPF neste contexto? A validação de CPF exige uma chamada à API com o número do documento e a chave de autenticação. A CPFHub.io retorna o status do CPF, nome do titular e data de nascimento em menos de 200ms, permitindo a verificação em tempo real durante o cadastro ou transação. ### A API CPFHub.io funciona para todos os volumes de consulta? Sim. O plano gratuito oferece 50 consultas por mês sem cartão de crédito — ideal para testes e projetos pequenos. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149. Se o limite for ultrapassado, a API não bloqueia: cobra R$0,15 por consulta adicional. ### Como garantir conformidade com a LGPD ao usar uma API de CPF? Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A [ANPD](https://www.gov.br/anpd) orienta que dados de identificação devem ser tratados com o princípio da necessidade. ### Quanto tempo leva para integrar a API CPFHub.io? A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para `https://api.cpfhub.io/cpf/{CPF}` com o header `x-api-key`. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens. ### Leia também - [APIs de CPF para plataformas de aluguel de imóveis: como validar inquilinos](https://cpfhub.io/blog/apis-cpf-plataformas-aluguel-imoveis-como-validar-inquilinos) - [APIs de CPF grátis para imobiliárias: como agilizar contratos?](https://cpfhub.io/blog/apis-de-cpf-gratis-para-imobiliarias-como-agilizar-contratos) - [KYC no Brasil: quais setores são obrigados a validar CPF por lei](https://cpfhub.io/blog/kyc-no-brasil-quais-setores-sao-obrigados-a-validar-cpf-por-lei) - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) --- ## Conclusão A validação de CPF é uma etapa fundamental em qualquer transação imobiliária, protegendo imobiliárias, proprietários e inquilinos contra fraudes de identidade, golpes e riscos legais. A integração com a API da [**CPFHub.io**](https://www.cpfhub.io/) leva menos de 30 minutos e os resultados aparecem imediatamente: menos fraudes, mais segurança jurídica e conformidade com as obrigações do COAF. Acesse [cpfhub.io](https://www.cpfhub.io/) para criar sua conta gratuitamente.