Os preços desta página são de tabela, sem assinatura — plano reduz o valor por consulta, e fonte de repasse cobra o emolumento da UF do alvo. O número que vale é o do POST /v1/orcamento/pesquisa-previa-bens, calculado sobre o alvo real e sem cobrar.
Operador Nacional do Sistema de Registro Eletrônico de Imóveis (ONR)
Pesquisa Prévia de Bens
Busca reversa de imóveis por CPF/CNPJ nos cartórios de registro de imóveis de um estado.
Site oficial da fonte ↗/v1/consultas/pesquisa-previa-bens
v1
UFs vendáveis
26/27
Cartórios
3.567
85 indisponíveis
Tempo típico
72s
A partir de
R$ 9,53
por consulta, varia por UF
Cobertura medida na origem em 19/08/2026, não copiada da divulgação dela. Cartório indisponível continua contado — sumir da conta esconderia o buraco em vez de declará-lo.
Visão geral
Responde "em quais matrículas este CPF/CNPJ aparece", varrendo os cartórios de registro de imóveis integrados ao ONR na UF escolhida. É a busca inversa: encontra o imóvel a partir da pessoa, e não a pessoa a partir do imóvel.
O resultado é INDÍCIO de titularidade, nunca confirmação. A prévia diz que o documento consta na matrícula — não a que título ele consta. Quem responde "é dono?" é a Pesquisa Qualificada, que é outro produto e cobra de novo.
A resposta traz, além dos achados, a PROVA DE ALCANCE: quantos cartórios foram efetivamente consultados, quantos estavam indisponíveis e quantos declararam acervo incompleto. É o que separa "esta pessoa não tem imóvel" de "procuramos em 320 cartórios e não achamos" — a segunda frase é a única que se sustenta num laudo.
Antes de começar
3 crítico · 3 de atenção · 3 de contexto
Cada item aqui saiu de um caso real que custou dinheiro. Ler isto é mais barato do que descobrir depois.
Repetir custa dinheiro de verdade
Esta não é uma consulta comum. Cada chamada PROTOCOLA UM ATO no cartório e debita o emolumento do saldo pré-pago. Não existe estorno depois do ato: se você repetir, você paga de novo.
Por isso o cabeçalho Idempotency-Key é obrigatório e não opcional. Mande a mesma chave e a mesma resposta volta, sem novo protocolo e sem nova cobrança. Chave nova é pedido novo.
Atenção: Cuidado com retry automático de biblioteca HTTP. Um timeout de rede do SEU lado não significa que o pedido não foi protocolado do NOSSO — significa só que você não viu a resposta. Reenvie com a MESMA chave, nunca com uma nova.
Uma UF por pedido, e o preço varia 16,1×
A origem busca por estado, não nacionalmente. Uma varredura Brasil inteiro são 26 chamadas e 26 cobranças — não existe parâmetro que faça isso numa só.
E o preço é emolumento de cartório, fixado por lei ESTADUAL, mais a nossa margem: entre a UF mais barata e a mais cara há 16,1 vezes de diferença. Orçar antes de disparar não é boa prática, é requisito.
O Maranhão está fora: a origem devolve emolumento R$ 0,00, e valor zero significa DESCONHECIDO, nunca grátis. Vender por R$ 0,00 seria prejuízo silencioso, então a UF não se oferece — falhamos fechado em vez de virar surpresa na fatura.
Negativa provisória não é "nada consta"
O ONR retenta cartório que não respondeu. Enquanto cobertura.retries_pendentes for true, a busca não fechou e o resultado ainda pode mudar.
Nesse estado, nada_consta volta false mesmo sem achado nenhum — de propósito. nada_consta: true é conclusão, e conclusão dispara evidência de ausência em laudo. Entregar como definitivo o que a origem ainda não fechou é vender conclusão que ninguém deu.
Mesma lógica para cobertura.leitura_parcial: se lemos menos cartórios do que a origem declara existir, um "não achamos" não cobre o estado inteiro.
Confira quem foi pesquisado
A resposta traz pesquisado_nome e pesquisado_documento — quem a ORIGEM diz ter pesquisado, com a grafia do cadastro dela. Pode divergir do que você mandou.
Divergência real já medida: alvo "JOAO PEDRO SCOZZAFAVE SALOMAO" e origem devolvendo "João Salomão". Um documento com um dígito diferente invalida a busca inteira, e sem esses dois campos ninguém percebe. Compare programaticamente antes de arquivar.
Matrícula nula não é ausência de imóvel
Um item de imoveis[] com matricula: null significa que a origem devolveu "matrícula não informada". O imóvel EXISTE e o documento consta nele; o que falta é o número.
Tratar isso como "não achou" é o erro de leitura mais caro deste contrato. Para obter o número é preciso a Pesquisa Qualificada, que é outro pedido e outra cobrança.
Finalidade é declaração legal
O campo finalidade é declarado AO CARTÓRIO. Não é preferência técnica nem filtro de busca.
Atenção: O valor 3 afirma que o solicitante É titular de direito real sobre o imóvel. Due diligence de imóvel de terceiro não é titularidade — marcar 3 ali é declaração falsa feita em nome do seu cliente. Por isso o padrão é 2.
Resultado é indício, não titularidade
A prévia responde "este documento aparece nesta matrícula". Aparecer não é ser dono: pode ser credor hipotecário, parte em averbação, ex-proprietário numa cadeia dominial.
confianca volta sempre INDICIO, e não existe valor que a faça voltar diferente. Quem confirma é a Pesquisa Qualificada.
Alcance temporal
A busca alcança registros a partir de 01/01/1976. O que é anterior está em livro de transcrição, fora da base indexada — e não aparece por nenhum parâmetro.
Comprovante nos dois desfechos
site_receipts[] traz a tela do ONR impressa, com protocolo e data. Ela sai tanto no achado quanto no "nada consta" — a prova de que a busca foi feita vale exatamente nos casos em que não se achou nada.
Requisição
Autenticação por token no cabeçalho. Parâmetro obrigatório que falta é recusado antes de qualquer cobrança — não vira consulta paga que volta vazia.
cpf_cnpj
string
obrigatório
CPF (11 dígitos) ou CNPJ (14 dígitos) do alvo da busca. Aceita com ou sem máscara.
uf
string(2)
obrigatório
Atenção: UMA UF por chamada — é assim que a origem funciona. Busca nacional são 26 chamadas e 26 cobranças. Ver a nota "Uma UF por pedido".
nome
string
opcional
Nome do alvo, quando conhecido. Ajuda a origem a desambiguar e volta na resposta como pesquisado_nome, para conferência.
finalidade
integer
opcional
Declaração AO CARTÓRIO, não preferência técnica. 1 = avaliação de crédito · 2 = investigação jurídica sobre o imóvel e sua titularidade (padrão) · 3 = o solicitante É titular de direito real. Ver a nota "Finalidade é declaração legal".
Idempotency-Key
header (UUID)
obrigatório
Atenção: Cabeçalho HTTP, obrigatório: cada chamada protocola um ato e debita emolumento; sem esta chave um retry seu paga duas vezes. Janela de 24 h. Nunca use CPF/CNPJ como chave — documento pessoal em header fica em log de acesso. Ver a nota "Repetir custa dinheiro de verdade".
curl -X POST https://api.oficialdata.com.br/v1/consultas/pesquisa-previa-bens \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"cpf_cnpj": "12345678000190",
"uf": "SP",
"nome": "EMPRESA EXEMPLO LTDA",
"finalidade": 2
}'
O HTTP é sempre 200 quando a requisição chegou.
O resultado real está em code, no corpo — trate
code, nunca o status.
Resposta
Dentro de data[]:
27 campos em 3 blocos.
Campo que a origem não informou volta null —
nunca 0 nem string vazia. Um zero inventado
vira "nada consta" num laudo.
data[]
object
Positiva quando houve achado, Negativa quando não houve.
Atenção: Só é true quando a busca FECHOU sem achado. Negativa provisória (provisorio: true) devolve false — ver a nota "Negativa provisória não é nada consta".
A origem ainda está retentando cartório que não respondeu. O resultado pode mudar.
Sempre INDICIO. A prévia não confirma titularidade.
Quantos imóveis foram encontrados.
Protocolo do pedido na origem. É a chave de reconciliação — guarde.
Quando a origem executou a busca.
UF efetivamente pesquisada.
Atenção: QUEM a origem diz ter pesquisado, com a grafia do cadastro dela — não quem você mandou. Confira: nome trocado invalida a busca inteira.
Documento efetivamente pesquisado, formatado. Mesma conferência.
Atenção: NÃO use como prova de identidade. A origem repete no resultado o nome que foi enviado no pedido, sem conferi-lo contra o documento — a única chave da busca é o CPF/CNPJ.
Resumo em português do que aconteceu, pronto para exibir ao usuário final.
Comprovante oficial arquivado: a tela do ONR impressa, com protocolo e data. É a peça que o cliente anexa ao processo.
imoveis[]
array
Atenção: Um item por MATRÍCULA EM QUE O DOCUMENTO APARECE — não é uma lista de imóveis do pesquisado. A origem não qualifica o papel: pode ser proprietário atual, ex-proprietário, cônjuge que deu anuência, fiador, usufrutuário, credor ou herdeiro. Não há data de ato no retorno. Confirmação de titularidade atual só por Pesquisa Qualificada ou certidão de inteiro teor.
Atenção: null quando a origem devolveu "matrícula não informada" — que NÃO é o mesmo que "não tem". Nesse caso só a Pesquisa Qualificada resolve, e ela cobra de novo.
Serventia onde a ocorrência foi encontrada.
Código Nacional de Serventia do cartório.
UF da serventia.
O cartório declarou acervo incompleto. Um achado daqui vale menos que um de cartório íntegro.
O cartório não respondeu nesta corrida.
cobertura
object
A PROVA DE ALCANCE da busca: onde se procurou e o quanto disso respondeu. É o que separa "não tem imóvel" de "procuramos e não achamos".
Serventias DISTINTAS que responderam. Confere com o "Total de cartórios pesquisados" do relatório oficial do ONR.
Linhas devolvidas pela origem. Passa do total de serventias sempre que há ocorrência: a serventia que acha volta repetida, uma linha por matrícula. Só serve para conferir a paginação (leitura_parcial).
Idêntico a linhas_na_origem. Mantido por compatibilidade; o nome engana e não deve ser usado como contagem de cartórios.
Quantas estavam fora do ar.
Quantas declararam acervo incompleto.
Atenção: true quando lemos MENOS do que a origem declara existir. Um "nada consta" com leitura parcial não é conclusivo.
A origem ainda não fechou a busca.
Quantas retentativas a origem já fez.
Códigos de erro
O mesmo mapa que o motor usa em produção. As colunas de estorno e retentativa fazem parte do contrato: nem toda falha devolve o dinheiro, e você tem direito de saber quais antes de integrar.
| Classe | Códigos | 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 |
A pegadinha do estorno:
erro_participante é a única
classe que não devolve o dinheiro — nela a
origem respondeu, recusando os dados do pedido. Falha nossa é
fatal e sempre estorna.
Permanentes: 602 e 603 não se curam sozinhos — não vale retentar. A fonte sai do ar na hora e um humano é avisado.
Preço por UF
É emolumento de cartório, fixado por lei estadual. Orçar antes de disparar em lote não é boa prática, é requisito.
Mais barata
R$ 9,53
SP
Mediana
R$ 36,46
26 UFs vendáveis
Mais cara
R$ 152,99
RJ — 16,1× a mais barata
Estes são os preços da sua conta. O valor é o emolumento do cartório mais a nossa margem, e a margem varia conforme o seu plano — planos maiores pagam menos por consulta.
AC
31,56
AL
54,45
AM
61,85
AP
45,75
BA
49,48
CE
38,74
DF
16,13
ES
10,13
GO
48,05
MG
56,13
MS
21,13
MT
31,23
PA
41,31
PB
93,04
PE
48,81
PI
20,01
PR
48,36
RJ
152,99
RN
19,66
RO
17,14
RR
11,20
RS
80,63
SC
28,18
SE
30,54
SP
9,53
TO
34,18
MA não se oferece. A origem devolve emolumento R$ 0,00, e valor zero significa desconhecido, nunca grátis. Sem preço confiável a UF sai da venda — falhar fechado é melhor do que virar surpresa na fatura.
Limites e desempenho
Números medidos em produção. Onde está "não medido", é porque não medimos — e um número chutado aqui viraria SLA que ninguém verificou.
Tempo típico
72s
p95
não medido
Teto por hora
50
Timeout máximo
180s
De onde vem o tempo: dos ~72s típicos, cerca de 85% é a origem varrendo os cartórios. Essa parte é intocável — não há otimização nossa que a reduza.
Sobre o teto: a origem exige sessão única por conta, então as corridas são serializadas. O número acima é o limite real de uma conta, não uma cota comercial. Volume acima disso exige combinar antes — não adianta paralelizar do seu lado.
Versionamento
O contrato de resposta é v1,
e a versão viaja em header.api_version
em toda resposta.
- Campo novo opcional pode entrar a qualquer momento e não muda a versão. Seu parser precisa ignorar campo que não conhece.
- Remover campo, renomear campo ou mudar tipo é versão nova, publicada em paralelo, com prazo de desligamento anunciado da anterior.
- Nunca alteramos o significado de um campo existente mantendo o nome. Se o significado muda, o nome muda junto.
Quer ser dos primeiros a integrar?
A ordem de liberação segue a demanda real. Diga o volume que você espera e em quais UFs.