Catálogo de APIs › Registro de imóveis

Registro de Imóveis

Visualização da matrícula

Conteúdo da matrícula (proprietário, ônus, penhoras, área e cadeia de atos) em PDF do cartório. Vale para imóvel urbano ou rural.

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
visualizacao-matricula
Preço
R$ 39,93 a partir de — o valor final depende do cartório
Aceita
Matrícula + cartório
Esfera
Cartórios e registros
Procedência
Parceiro de integração
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.
imovel_matricula Sim Número da matrícula do imóvel.
imovel_cartorio Sim Cartório de registro de imóveis onde a matrícula está registrada.
imovel_municipio Sim Município do imóvel.
imovel_uf Sim UF do imóvel.

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.
  • Duas etapas A primeira etapa protocola o pedido e devolve o número; a segunda obtém o documento depois, em dias úteis.
  • 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.
  • Bloqueio estornado Se a origem bloquear sem entregar nada, o valor é estornado, mesmo quando o provedor fatura a chamada.
  • Saldo na origem O custo sai de um saldo pré-pago nosso na origem. Sem caixa, o pedido fica represado e avisado — nunca falha como se o problema fosse seu.
  • Códigos reinterpretados Esta fonte reinterpreta pelo menos um código de retorno: o mesmo número significa coisas diferentes em origens diferentes.

Antes de integrar

Ressalvas sobre o que esta consulta é — e o que ela não é.

  • 2 etapas Sai em 2 etapas: o pedido é protocolado e o documento é emitido depois. Pode levar alguns dias úteis — avisamos quando ficar pronto.
  • Exige matrícula Exige número da matrícula, cartório (1 = 1º RI), município e UF — e o município é o do CARTÓRIO, não o do imóvel. Se você não tem a matrícula, a Pesquisa Prévia ("Pesquisa de matrículas por CPF/CNPJ") localiza as matrículas associadas ao documento na UF escolhida; sendo imóvel rural com CAR, o mapa do serviço de registro de imóveis aponta a serventia.
  • Simples consulta O documento sai carimbado "PARA SIMPLES CONSULTA — NÃO VALE COMO CERTIDÃO". Serve para investigar e decidir; para escritura ou financiamento é preciso a certidão de inteiro teor.
  • PDF digitalizado A matrícula vem como imagem escaneada pelo cartório, do jeito que o livro foi registrado — leitura humana, sem campos pesquisáveis.
  • Urbano e rural Vale para imóvel urbano e rural: a matrícula é do registro de imóveis da comarca, seja apartamento, terreno ou fazenda.
  • Cobertura parcial Só sai onde o cartório está integrado ao a maior parte do país, não o país inteiro. E a visualização alcança MENOS municípios que a certidão de inteiro teor: há comarca que emite certidão e não oferece visualização. O município que vale é o do CARTÓRIO onde a matrícula está registrada, que pode não ser o do imóvel.

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

‹ Voltar ao catálogo