Catálogo de APIs › Registro de imóveis

Operador Nacional do Sistema de Registro Eletrônico de Imóveis (ONR)

Matrícula do imóvel — visualização (RI Digital/ONR)

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.

Site oficial da fonte ↗

Integração por API em construção. Esta consulta já roda hoje na plataforma, pela tela. O contrato abaixo é o que a API vai expor quando abrir.

Ficha

Estado medido agora, no mesmo lugar de onde a venda decide — não numa tabela mantida à parte.

Identificador
registradores_matricula
Preço
R$ 12,84 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 Cada chamada protocola um ato na origem e debita o emolumento. Não existe estorno depois do ato: repetir por retry automático paga duas vezes. Esta fonte exige chave de idempotência.
  • 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 ("Imóveis do titular — busca por CPF/CNPJ") localiza as matrículas do alvo na UF escolhida; sendo imóvel rural com CAR, o mapa do ONR 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 ONR — 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