Registro de Imóveis
Pesquisa de matrículas por CPF/CNPJ (serviço de registro de imóveis)
Em quais matrículas o CPF/CNPJ do alvo aparece, varrendo os cartórios de registro de imóveis do estado escolhido — urbano ou rural. É a busca inversa: encontra o imóvel a partir da pessoa. Resultado é INDÍCIO de titularidade — diz que o documento consta na matrícula, não a que título. Uma UF por pedido; alcança registros a partir de 01/01/1976 (antes é transcrição).
Esta consulta já responde por API.
Autenticação por Bearer, orçamento antes da cobrança e resultado por
protocolo. Parâmetros, campos de resposta e códigos de erro em
api.oficialdata.com.br.
Ficha
Estado medido agora, no mesmo lugar de onde a venda decide — não numa tabela mantida à parte.
- Identificador
- pesquisa-previa-bens
- Preço
- R$ 37,62 a partir de — o valor final depende do cartório
- Aceita
- CPF/CNPJ + UF
- Esfera
- Cartórios e registros
- Procedência
- Integração própria
- Na plataforma
- Disponível
Parâmetros
O que a consulta exige para rodar. Parâmetro obrigatório que falta é recusado antes de qualquer cobrança — não vira consulta paga que volta vazia.
| Parâmetro | Obrigatório | O que é |
|---|---|---|
| cpf_cnpj | Sim | CPF (11 dígitos) ou CNPJ (14 dígitos) do alvo. |
| uf | Sim | Sigla da UF onde consultar. A cobertura varia por estado. |
| uf | Sim | Sigla da UF onde consultar. |
Comportamento
O que esta fonte faz de diferente das outras — prazo, cobrança, repetição, recusa. Cada cláusula aqui saiu de um caso real que custou dinheiro; está publicada para que a sua integração não pague por ele de novo.
- Repetir cobra de novo Um pedido novo pode protocolar um ato e debitar emolumento. O ato já praticado não estorna. Cada POST sem identificador opcional inicia uma consulta nova. Acompanhe o protocolo por GET; se a resposta se perder, confira o histórico antes de reenviar.
- Preço varia por alvo O preço depende do alvo (emolumento fixado por lei estadual e variável por município). O valor anunciado é o piso: orce antes de chamar.
- Resposta em minutos Aceita o pedido na hora e responde em minutos de relógio. A integração recebe um protocolo e acompanha até o resultado fechar.
- Recusa antes de cobrar Quando a origem recusaria o pedido — por exemplo, um pedido anterior da mesma matrícula ainda vigente —, a resposta vem antes de qualquer cobrança, dizendo quando libera.
Antes de integrar
Ressalvas sobre o que esta consulta é — e o que ela não é.
- Cobertura por estado A prévia é POR ESTADO: você escolhe a UF e ela varre os cartórios integrados dali. O município do imóvel não entra no pedido, e a origem não publica quais serventias respondem por este serviço. Cada UF é um pedido e uma cobrança, e o emolumento varia 16x entre estados.
- Urbano e rural A varredura cobre o acervo do registro de imóveis da UF, sem separar urbano de rural: aparece a matrícula em que o CPF/CNPJ consta, seja apartamento, terreno ou fazenda.
Códigos de retorno
A resposta HTTP é sempre 200; o resultado real está no campo code. A coluna de estorno faz parte do contrato: nem toda falha devolve o dinheiro, e você tem direito de saber quais antes de integrar.
| Classe | Códigos | O que significa | Estorna | Retenta |
|---|---|---|---|---|
| sucesso | 200 | A origem respondeu e entregou. | — | — |
| nao_encontrado | 612 | A origem respondeu: nada consta para este alvo. | Não | Não |
| indeterminado | 611 | A origem não conseguiu emitir pela internet. Não é irregularidade. | Não | Não |
| erro_participante | 608, 619, 620 | A origem recusou os DADOS do pedido. | Não | Sim |
| retry | 600, 605, 609, 610, 613, 614, 615, 618 | Instabilidade momentânea da origem ou do transporte. | Sim | Sim |
| fatal | 601, 602, 603, 604, 606, 607, 617, 621, 622 | Defeito de integração — nosso, não seu. | Sim | Não |
Permanentes: 602 e 603 não se curam sozinhos — a fonte sai do ar na hora e um humano é avisado.
Precisa desta consulta por API?
Diga qual volume você espera. A ordem de liberação segue a demanda real.
Falar sobre integração