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/certidao-inteiro-teor, calculado sobre o alvo real e sem cobrar.
Operador Nacional do Sistema de Registro Eletrônico de Imóveis (ONR)
Certidão de Inteiro Teor
A certidão de inteiro teor da matrícula, com fé pública e assinatura digital do cartório.
Site oficial da fonte ↗/v1/consultas/certidao-inteiro-teor
v1
Tempo típico
não medido
A partir de
R$ 96,83
por consulta, varia por UF
Visão geral
Solicita ao registro de imóveis a certidão de inteiro teor da matrícula e devolve o PDF oficial, assinado digitalmente pelo oficial do registro. É o documento com FÉ PÚBLICA: oponível a terceiros, aceito para instruir processo, registrar ato e fechar negócio.
O conteúdo é o mesmo da Visualização de Matrícula — titular, ônus, penhoras, cadeia de atos. O que se paga a mais é a assinatura do cartório e o valor jurídico que ela carrega. Se o seu caso é decisão interna ou triagem, a visualização entrega o mesmo texto em minutos e por uma fração do preço.
Atenção: É ASSÍNCRONA e o prazo corre em HORAS ÚTEIS do cartório (das 09h00 às 16h00, de segunda a sexta). A resposta imediata é o protocolo; o documento chega depois. Pedido de sexta à tarde sai na segunda.
Antes de começar
6 crítico · 3 de atenção
Cada item aqui saiu de um caso real que custou dinheiro. Ler isto é mais barato do que descobrir depois.
São HORAS ÚTEIS do cartório, não horas de relógio
O prazo publicado é de cerca de 4 horas úteis, e ele corre apenas dentro do expediente da serventia (das 09h00 às 16h00, de segunda a sexta). Um pedido feito às 15h de sexta não vence às 19h — vence na segunda de manhã.
previsao_entrega_em já vem com essa conta feita, em ISO-8601. Use esse campo para prometer prazo ao seu usuário final, nunca uma soma de horas sua.
O prazo é do cartório, e a fila dele não é nossa para administrar. Alguns entregam em minutos; outros usam o prazo inteiro.
Enquanto processa, a origem responde "nada aqui" — e isso é normal
Durante toda a fila do cartório, a rota de download da origem devolve o pedido como "Em Aberto". Isso NÃO é erro nem ausência de documento: é a certidão ainda sendo emitida.
Nós tratamos isso como "ainda processando" e continuamos verificando sozinhos, com intervalo crescente, até 24 vezes. Você não precisa fazer nada: GET /v1/consultas/{protocolo} responde 202 nesse período.
Atenção: Não reenvie o pedido por causa disso. Um segundo pedido da mesma matrícula é recusado pelo cartório, e a recusa é faturada pela origem.
Sem rota de reconciliação: o protocolo é insubstituível
A visualização de matrícula tem uma lista de pedidos na origem que nos permite descobrir, depois de um timeout, se o ato foi protocolado. **A certidão não tem.** Medimos duas vezes: a lista de pedidos do portal não enxerga o módulo de certidões, e o download exige o número do pedido.
Consequência prática: se o protocolo se perder, o documento e o emolumento se perdem com ele — só um login humano no portal recupera. Por isso guardamos o protocolo antes de qualquer coisa, e por isso a chave de idempotência é obrigatória.
Guarde identificadores.numero_pedido do seu lado também, assim que ele aparecer. É barato, e é a única cópia que não depende de nós.
Cada chamada gasta emolumento de cartório, e não tem desfazer
O preço não é tarifa nossa: é o emolumento que o registro de imóveis cobra, fixado por tabela estadual, mais a nossa margem. Ele sai da nossa conta pré-paga no portal no momento do pedido, e ato registral não estorna.
Atenção: Por isso Idempotency-Key é obrigatória. Mesma chave devolve a mesma resposta, sem protocolar de novo e sem cobrar de novo. Chave nova é pedido novo, ainda que o imóvel seja o mesmo.
Cuidado com retry automático de biblioteca HTTP: um timeout do SEU lado não significa que o pedido não saiu do nosso — significa que você não viu a resposta. Reenvie com a MESMA chave.
O preço só se sabe orçando — varia por cartório
Não existe tabela nacional. O emolumento muda por estado e por serventia, então o valor publicado no card é PISO ("a partir de"), nunca o preço do seu pedido.
Use POST /v1/orcamento/certidao-inteiro-teor com os mesmos quatro campos do imóvel: ele cota na origem, não cobra e devolve preco.total com estimado: true. É o único número que bate com a fatura.
Atenção: Cartório que não cota não é vendido. Município escrito errado, serventia inexistente ou tabela indisponível fazem a consulta responder 602 (indisponível) SEM chamar a origem e SEM cobrar — em vez de protocolar um pedido que ninguém sabe quanto custa.
O bloqueio de pedido repetido é da CONTA, não da sua
O RI Digital recusa um segundo pedido da mesma matrícula, no mesmo cartório, enquanto o anterior estiver vigente. A recusa vem faturada pela origem e não entrega documento nenhum — por isso nós barramos antes, e a resposta é 602 sem cobrança.
Atenção: A plataforma opera com UMA conta no portal para toda a carteira. Isso significa que um pedido feito por outro cliente nosso, do mesmo imóvel, bloqueia o seu enquanto estiver vigente. A janela em uso é de 7 dias, e ela é estimativa: o portal não devolve o prazo real de vigência.
A resposta diz a data a partir da qual o pedido volta a ser aceito. Se o volume do seu produto tornar isso frequente, o caminho é uma credencial dedicada no portal — fale com o suporte antes de escalar.
O link da origem morre em 7 dias — use o nosso
A URL do PDF que o cartório devolve é assinada e expira: medido em 2026-08-11, validade de 7 dias. Guardar essa URL e abrir semanas depois entrega link morto de um documento que já custou emolumento.
Nós arquivamos os bytes na entrega. Use documento_url da resposta — ela aponta para o nosso arquivo, autentica com o mesmo Bearer e não expira. site_receipts[] continua trazendo a URL da origem para conferência.
Inteiro teor não é certidão negativa
Esta certidão reproduz o que está registrado na matrícula. Ela não afirma que o imóvel está livre de ônus nem que o titular nada deve — quem lê o conteúdo e conclui é você.
Por isso não existe nada_consta nesta resposta. status: Emitida significa que o documento saiu, não que ele é favorável.
A validade do documento não é medida por nós
A certidão tem prazo de validade declarado pelo cartório, mas ele está na camada de imagem do PDF — não sai em campo estruturado. Nós não o extraímos, e por isso esta API não entra no nosso alerta de vencimento de certidões.
Preferimos não devolver campo nenhum a devolver uma data chutada: alerta na data errada sobre um documento de fé pública é pior que alerta nenhum. Confira a validade no próprio PDF.
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
Atenção: O CONSULENTE, não o dono do imóvel. É a quem a consulta fica associada na sua conta e no seu extrato — o documento sai do imóvel, não deste CPF/CNPJ. Aceita com ou sem máscara.
imovel_matricula
string
obrigatório
Número da matrícula OU o CNM (Código Nacional de Matrícula). Zeros à esquerda são aceitos.
imovel_cartorio
integer
obrigatório
Atenção: O NÚMERO do registro de imóveis, inteiro: 1 para o 1º RI. Mandar "1º RI - Taquaritinga" é 607 faturado pela origem.
imovel_municipio
string
obrigatório
Atenção: Município DO CARTÓRIO, não do imóvel. Medido em 2026-08-11: um imóvel de Fernando Prestes está matriculado no RI de Taquaritinga. Errar aqui não protocola nada — a cotação falha e a consulta fica indisponível sem cobrar.
imovel_uf
string(2)
obrigatório
UF do cartório.
Idempotency-Key
header (UUID)
obrigatório
Atenção: Cabeçalho HTTP, obrigatório e mais crítico aqui do que em qualquer outra API nossa: o emolumento é o maior da plataforma e a certidão NÃO tem rota de reconciliação. Janela de 24 h.
curl -X POST https://api.oficialdata.com.br/v1/consultas/certidao-inteiro-teor \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"cpf_cnpj": "12345678000190",
"imovel_matricula": "21916",
"imovel_cartorio": 1,
"imovel_municipio": "Taquaritinga",
"imovel_uf": "SP"
}'
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[]:
8 campos em 2 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
EM_EMISSAO enquanto o cartório processa, SUCESSO quando o PDF chega, INDISPONIVEL quando o pedido foi aceito sem protocolo (caso em que o valor volta integralmente).
Emitida no documento entregue. É o estado do DOCUMENTO, não um veredito sobre o imóvel — inteiro teor não é certidão negativa.
Quando o documento deve estar pronto, já calculado em horas ÚTEIS do expediente do cartório.
Atenção: A ENTREGA. Aponta para o nosso arquivo, autentica com o mesmo Bearer e NÃO expira. A URL da origem morre em 7 dias.
Código do validador de assinatura do ONR, impresso na camada de texto do PDF. É por ele que um terceiro confere a autenticidade.
Frase pronta para tela: no EM_EMISSAO traz protocolo, prazo e previsão; no SUCESSO, a confirmação de fé pública.
⚠️ URL do PDF NA ORIGEM. Expira em 7 dias — conferência e auditoria, não o seu link.
identificadores
object
Atenção: Protocolo no cartório. GUARDE ESTE NÚMERO: sem ele não há como baixar a certidão, e não existe lista que o recupere. Perder o protocolo é perder o documento e o emolumento.
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$ 96,83
BR
Mediana
R$ 96,83
1 UFs vendáveis
Mais cara
R$ 96,83
BR — 1,0× 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.
BR
96,83
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
não medido
p95
não medido
Teto por hora
—
Timeout máximo
540s
De onde vem o tempo: dos ~s 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.