Appearance
Exemplos de Requisição
Os consumidores devem fixar a versão da API via URL (/v1/). Os exemplos abaixo citam o Host (Url-base) de homologação, porém as chamadas de serviços para cada ambiente devem tomar como referência endereços descritos em Tabela de Ambientes.
Tratamento de HTTP 429 (Too Many Requests)
Os serviços que operam sobre uma única UI (inclusão, alteração e desativação) são projetados para chamadas pontuais. Ao serem usados em volume, podem ocorrer falhas por violação dos limites de tráfego do sistema —
1) exaustão de conexões ou
2) instabilidade temporária — sinalizadas pelo código HTTP 429 (Too Many Requests) e a mensagem de erro correspondente.
Caso esse código seja retornado, reforçamos a necessidade de usar esses serviços com o propósito ao qual foram projetados e orientamos que o consumidor migre para um dos fluxos em lote abaixo:
| Fluxo | Como funciona | Quando usar |
|---|---|---|
| Opção A — Síncrono via ndJSON | Envio de várias Unidades Imobiliárias aglutinadas em um único payload no formato ndJSON (Newline Delimited JSON). | Volumes médios de dados, em que a confirmação imediata é necessária. |
| Opção B — Assíncrono via arquivo compactado | As UIs são gravadas em um arquivo ndJSON, compactado em .zip e enviado pelo endpoint assíncrono. O processamento ocorre em segundo plano pela API. | Volumes massivos de dados. Evita timeouts HTTP, é escalável e não compromete as requisições concorrentes em tempo real. |
O serviço correspondente a cada operação unitária:
| Operação unitária | Opção A — ndJSON síncrono | Opção B — arquivo .zip assíncrono |
|---|---|---|
| Serviço de Inclusão de uma única UI | Serviço de Inclusão de múltiplas UIs | Serviço de recepção de UI’s por arquivo |
| Alteração de uma única UI | Alteração de múltiplas UIs | Serviço de recepção de UI’s por arquivo |
| Desativação de uma única UI | Desativação de múltiplas UIs | Serviço de recepção de UI’s por arquivo |
Serviço de Inclusão de uma única UI
⚠️ Esse serviço deve ser utilizado para inclusão de uma única UI, caso seja necessário incluir mais de uma UI, deve-se utilizar o serviço de inclusão de múltiplas UIs.
POST /api/v1/{codigoIbge}/ui HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Content-Type: application/json
Accept: application/jsonCorpo da Requisição:
json
{
"DadosGeraisImovel": {
"inscricaoImobiliaria": "1234567890123456789012345",
"tipoImovel": 3,
"tpArquitetonico": 12,
"destinacaoImovel": 2,
"idParcela": "PARC-12345",
"areaTerreno": 350.75,
"areaConstruida": 120.5,
"bice": null,
"anoConstrutivo": 2005,
"valorVenal": 450000,
"dtUltimoValorVenal": "2024-12-01",
"padraoConstrutivo": 3,
"qtdGaragem": 2,
"temPiscina": false,
"valorRefMercado": 520000,
"dataUltVlrMercado": "2024-12-15"
},
"AreaConstruidaCompl": {
"areaPrivativa": 100.25,
"areaComum": 20.25,
"fraIdeal": 0.5
},
"EnderecoImovel": {
"tipoLogradouro": 100,
"nomeLogradouro": "Avenida Brasil",
"temBairro": true,
"bairro": "Centro",
"cep": "70040900",
"numeroImovel": "1234",
"complNroImovel": "BL A",
"complEndereco": "APT 201"
},
"Titular": [
{
"niTitular": "12345678901",
"nomeTitular": "JOAO DA SILVA",
"percTitularidade": 1,
"dtAquisicaoTitular": "2023-05-20",
"tipoTitularidade": 1,
"docTitularidade": 1
}
],
"ServicoRegistroImovel": {
"nomeServentiaRI": "CARTORIO REGISTRO GERAL",
"cnsRI": 123456,
"cnmRI": 789012,
"numMatriculaRI": "MAT123456789",
"numUltimoAtoRI": "ATO987654321",
"lvCartRI": "LV01",
"flCartRI": "FL02",
"dtUltAtualizacao": "2024-11-30"
},
"CartorioNotas": {
"nomeServentiaNotas": "CARTORIO NOTAS CENTRAL",
"cnsNotas": 555555,
"lvCartNotas": "LN01",
"flCartNotas": "FL01"
},
"ITBI": {
"baseCalculITBI": 500000,
"dtTransacaoITBI": "2024-10-10",
"tpTransacaoITBI": 1,
"percTransacionadoITBI": 1,
"TransmitenteITBI": [
{
"nomeTransmitenteITBI": "MARIA PEREIRA",
"idTransmitenteITBI": "12345678901234"
}
],
"AdquirenteITBI": [
{
"nomeAdquirenteITBI": "JOAO DA SILVA",
"idAdquirenteITBI": "12345678901",
"percTransacAdquirenteITBI": 1
}
],
"valorRefITBI": 500000
}
}Resposta:
json
{
"id": 1,
"uiIncluida": {
"inscricaoImobiliaria": "123456789",
"cib": {
"valor": "EjkgXqle",
"situacao": "Ativo"
},
"refUi": "https://api.receitafederal.gov.br/prr-sinter/api/v1/ui/{cib}"
}
}⚠️ HTTP 429 (Too Many Requests) — em caso de exaustão de conexões ou instabilidade temporária, este serviço pode retornar HTTP 429. Nesse cenário, utilize um dos fluxos em lote: Serviço de Inclusão de múltiplas UIs (ndJSON síncrono) ou Serviço de recepção de UI’s por arquivo (arquivo .zip assíncrono). Detalhes em Tratamento de HTTP 429 (Too Many Requests).
Serviço de Inclusão de múltiplas UIs
⚠️ Esse serviço deve ser utilizado para inclusão de múltiplas UIs e cada chamada deve conter, no máximo, 200 UI's
POST /api/v1/{codigoIbge}/uis HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Content-Type: application/ndjson
Accept: application/jsonCorpo da Requisição:
json
{"DadosGeraisImovel":{"inscricaoImobiliaria":"2234567890123456789012388","temBairro":true,"tipoImovel":3,"tpArquitetonico":11,"destinacaoImovel":2,"idParcela":"PARC-12345","areaTerreno":350.75,"areaConstruida":120.5,"bice":1,"anoConstrutivo":2005,"valorVenal":450000,"dtUltimoValorVenal":"2024-12-01","padraoConstrutivo":3,"qtdGaragem":2,"temPiscina":false,"valorRefMercado":520000,"dataUltValorMercado":"2024-12-15"},"AreaConstruidaCompl":{"areaPrivativa":100.25,"areaComum":20.25,"fraIdeal":0.5},"EnderecoImovel":{"tipoLogradouro":100,"nomeLogradouro":"Avenida Brasil","bairro":"Centro","cep":"70040900","numeroImovel":"1234","complEndereco": "APT 201"},"Titular":[{"niTitular":"12345678901","nomeTitular":"JOAO DA SILVA","percTitularidade":1,"dtAquisicaoTitular":"2023-05-20","docTitularidade":1,"tipoTitularidade":1}],"ServicoRegistroImovel":{"nomeServentiaRI":"CARTORIO REGISTRO GERAL","cnsRI":123456,"cnmRI":789012,"numMatriculaRI":"MAT123456789","numUltimoAtoRI":"ATO987","lvCartRI":"LV01","flCartRI":"FL02","dtUltAtualizacao":"2024-11-30"},"CartorioNotas":{"nomeServentiaNotas":"CARTORIO NOTAS CENTRAL","cnsNotas":555555,"lvCartNotas":"LN01","flCartNotas":"FL01"},"ITBI":{"baseCalculITBI":500000,"dtTransacaoITBI":"2024-10-10","tpTransacaoITBI":1,"percTransacionadoITBI":1,"TransmitenteITBI":[{"nomeTransmitenteITBI":"MARIA PEREIRA","idTransmitenteITBI":"12345678901234"}],"AdquirenteITBI":[{"nomeAdquirenteITBI":"JOAO DA SILVA","idAdquirenteITBI":"12345678901","percTransacAdquirenteITBI":1}],"valorRefITBI":500000}}
{"DadosGeraisImovel":{"inscricaoImobiliaria":"2234567890123456789012397","temBairro":true,"tipoImovel":3,"tpArquitetonico":11,"destinacaoImovel":2,"idParcela":"PARC-12345","areaTerreno":350.75,"areaConstruida":120.5,"bice":1,"anoConstrutivo":2005,"valorVenal":450000,"dtUltimoValorVenal":"2024-12-01","padraoConstrutivo":3,"qtdGaragem":2,"temPiscina":false,"valorRefMercado":520000,"dataUltValorMercado":"2024-12-15"},"AreaConstruidaCompl":{"areaPrivativa":100.25,"areaComum":20.25,"fraIdeal":0.5},"EnderecoImovel":{"tipoLogradouro":100,"nomeLogradouro":"Avenida Brasil","bairro":"Centro","cep":"70040900","numeroImovel":"1234","complNroImovel":"BLA","complEndereco":"APTTitular":"12345678901","nomeTitular":"JOAO DA SILVA","percTitularidade":1,"dtAquisicaoTitular":"2023-05-20","docTitularidade":1,"tipoTitularidade":1}],"ServicoRegistroImovel":{"nomeServentiaRI":"CARTORIO REGISTRO GERAL","cnsRI":123456,"cnmRI":789012,"numMatriculaRI":"MAT123456789","numUltimoAtoRI":"ATO987","lvCartRI":"LV01","flCartRI":"FL02","dtUltAtualizacao":"2024-11-30"},"CartorioNotas":{"nomeServentiaNotas":"CARTORIO NOTAS CENTRAL","cnsNotas":555555,"lvCartNotas":"LN01","flCartNotas":"FL01"},"ITBI":{"baseCalculITBI":500000,"dtTransacaoITBI":"2024-10-10","tpTransacaoITBI":1,"percTransacionadoITBI":1,"TransmitenteITBI":[{"nomeTransmitenteITBI":"MARIA PEREIRA","idTransmitenteITBI":"12345678901234"}],"AdquirenteITBI":[{"nomeAdquirenteITBI":"JOAO DA SILVA","idAdquirenteITBI":"12345678901","percTransacAdquirenteITBI":1}],"valorRefITBI":500000}}Resposta:
json
[
{
"id": 1,
"uiIncluida": {
"inscricaoImobiliaria": "2234567890123456789012398",
"cib": {
"valor": "M65SBES1",
"situacao": "Ativa"
},
"refUi": "https://api.receitafederal.gov.br/prr-sinter/api/v1/ui/M65SBES1"
},
"camposInvalidos": [
{
"campo": "titular.niTitular",
"erro": "Ni do titular inválido.",
"idFalha": "0103 "
},
{
"campo": "servicoRegistroImovel.cnmRI",
"erro": "Formato do campo inválido. (apenas números, 15 ou 16 dígitos)",
"idFalha": "0102"
},
{
"campo": "adquirenteITBIDTO.idAdquirenteITBI",
"erro": "NI do Adquirente ITBI inválido.",
"idFalha": "0103 "
},
{
"campo": "transmitentesITBI.idTransmitenteITBI",
"erro": "NI do Transmitente ITBI inválido.",
"idFalha": "0103 "
}
],
"mensagem": null
},
{
"id": 1,
"uiIncluida": {
"inscricaoImobiliaria": "2234567890123456789012399",
"cib": {
"valor": "X455X55C",
"situacao": "Ativa"
},
"refUi": "https://api.receitafederal.gov.br/prr-sinter/api/v1/ui/X455X55C"
},
"camposInvalidos": [
{
"campo": "titular.niTitular",
"erro": "Ni do titular inválido.",
"idFalha": "0103 "
},
{
"campo": "servicoRegistroImovel.cnmRI",
"erro": "Formato do campo inválido. (apenas números, 15 ou 16 dígitos)",
"idFalha": "0102"
},
{
"campo": "adquirenteITBIDTO.idAdquirenteITBI",
"erro": "NI do Adquirente ITBI inválido.",
"idFalha": "0103 "
},
{
"campo": "transmitentesITBI.idTransmitenteITBI",
"erro": "NI do Transmitente ITBI inválido.",
"idFalha": "0103 "
}
],
"mensagem": null
}
]Serviço de recepção de UI’s por arquivo
POST /api/v1/{codigoIbge}/arquivos HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Content-Type: multipart/form-dataCorpo da Requisição:
arquivo: caminho para o arquivo zip contendo os dados na máquina do transmissor.
Exemplo de Registro de Inclusão por Arquivo
json
{"ui": {"ITBI": {"baseCalculITBI": 433229.56, "valorRefITBI": 574811.05, "percTransacionadoITBI": 0.33, "TransmitenteITBI": [{"nomeTransmitenteITBI": "Sophia Albuquerque", "idTransmitenteITBI": "67642690414057"}], "AdquirenteITBI": [{"percTransacAdquirenteITBI": 0.42, "nomeAdquirenteITBI": "João Miguel de Quadros e Associados", "idAdquirenteITBI": "07875395679"}], "dtTransacaoITBI": "2025-04-15", "tpTransacaoITBI": 31}, "AreaConstruidaCompl": {"fraIdeal": 0.47, "areaPrivativa": 23.79, "areaComum": 176.78}, "Titular": [{"docTitularidade": 1, "nomeTitular": "SAMUEL SANTANA", "dtAquisicaoTitular": "2021-04-27", "percTitularidade": 1.0, "niTitular": "26638136477", "tipoTitularidade": 9}], "DadosGeraisImovel": {"tpArquitetonico": 1, "areaTerreno": 563.53, "bice": 12, "valorVenal": 724014.83, "idParcela": "PARC-65741", "valorRefMercado": 772512.22, "temBairro": true, "inscricaoImobiliaria": "0000000000045050930230685", "destinacaoImovel": 14, "areaConstruida": 618.7, "tipoImovel": 1, "anoConstrutivo": 1986, "qtdGaragem": 2, "dataUltVlrMercado": "2025-03-06", "padraoConstrutivo": 4, "dtUltimoValorVenal": "2025-05-31", "temPiscina": false}, "ServicoRegistroImovel": {"dtUltAtualizacao": "2025-04-20", "numMatriculaRI": "769049557774403", "flCartRI": "ie31", "cnsRI": 992530, "numUltimoAtoRI": "8895611", "lvCartRI": "yn21", "nomeServentiaRI": "Xavier LTDA", "cnmRI": "5401843258238825"}, "EnderecoImovel": {"numeroImovel": "5660", "nomeLogradouro": "Rua Maitê Gomide", "bairro": "Almeirim", "tipoLogradouro": 25, "complNroImovel": "BL r", "complEndereco": "APT 105", "cep": "22884541"}, "CartorioNotas": {"nomeServentiaNotas": "Taveira, Hernandes e de Lins", "flCartNotas": "ml88", "cnsNotas": 704972, "lvCartNotas": "vg42"}}, "operacao": "I"}Exemplo de Registro de Alteração por Arquivo
json
{"ui":{"cib": "NR79HT1E", "DadosGeraisImovel":{"inscricaoImobiliaria":"0000000000000990187468378","temBairro":true,"tipoImovel":3,"tpArquitetonico":11,"destinacaoImovel":2,"idParcela":"PARC-12345","areaTerreno":350.75,"areaConstruida":120.5,"bice":1,"anoConstrutivo":2005,"valorVenal":450000,"dtUltimoValorVenal":"2024-12-01","padraoConstrutivo":3,"qtdGaragem":2,"temPiscina":false,"valorRefMercado":520000,"dataUltVlrMercado":"2024-12-15"},"AreaConstruidaCompl":{"areaPrivativa":100.25,"areaComum":20.25,"fraIdeal":0.5},"EnderecoImovel":{"tipoLogradouro":100,"nomeLogradouro":"Avenida Brasil","bairro":"Centro","cep":"70040900","numeroImovel":"1234","complNroImovel":"BL A","complEndereco":"APT 201"},"Titular":[{"niTitular":"12345678901","nomeTitular":"JOAO DA SILVA PLINIO BRITO","percTitularidade":1,"dtAquisicaoTitular":"2023-05-20","docTitularidade":1,"tipoTitularidade":1}],"ServicoRegistroImovel":{"nomeServentiaRI":"CARTORIO REGISTRO GERAL","cnsRI":123456,"cnmRI":789012,"numMatriculaRI":"MAT123456789","numUltimoAtoRI":"ATO987","lvCartRI":"LV01","flCartRI":"FL02","dtUltAtualizacao":"2024-11-30"},"CartorioNotas":{"nomeServentiaNotas":"CARTORIO NOTAS CENTRAL","cnsNotas":555555,"lvCartNotas":"LN01","flCartNotas":"FL01"},"ITBI":{"baseCalculITBI":500000,"dtTransacaoITBI":"2024-10-10","tpTransacaoITBI":1,"percTransacionadoITBI":1,"TransmitenteITBI":[{"nomeTransmitenteITBI":"MARIA PEREIRA","idTransmitenteITBI":"12345678901234"}],"AdquirenteITBI":[{"nomeAdquirenteITBI":"JOAO DA SILVA","idAdquirenteITBI":"12345678901","percTransacAdquirenteITBI":1}],"valorRefITBI":500000},"DadosGeo":{"idPonto":1001,"idTestada":2002,"idLote":3003}},"operacao":"A"}Exemplo de Registro de Desativação por Arquivo
json
{"ui":{"inscricaoImobiliaria":"0000000000029540347831831","cib":"QFZXA0P1","tipoDesativacao":2,"motivoDesativacao":9,"complemento":"texto"},"operacao":"D"}Resposta:
json
{ "idArquivo": "4314902_1763401799631", "nomeArquivo": "4314902_1763401799631.zip", "status": "PENDENTE"}Obs.: O idArquivo é a composição do código IBGE e o timestamp atual.
Para ilustrar melhor esse método, segue exemplo de uma chamada usando a ferramenta curl. Perceba que estamos passando a opção “--form” no comando, o que automaticamente já inclui o método POST HTTP, bem como o Content-Type: multipart/form-data:
bash
curl --location 'https://api.receitafederal.gov.br/prr-sinter/api/v1/arquivos/4314902' \ --header 'Authorization: Bearer
eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJvWTNuN0trMWJyUnBhVnZVQTBob0V6d0lXZjV5Vk I4TWtIVHUwclpzT0F3In0.eyJleHAiOjE3NjM0MDI2ODYsImlhdCI6MTc2MzQwMTc4NiwianRpIjoidHJydGNj OmJlNWUyMmJhLTA1YTktNDY0Yy1iYjFhLTQ4YzM1OGNhYjc0ZiIsImlzcyI6Imh0dHBzOi8vZGVzLWtleWN sb2NrLXNpbnRlcjItY2FkdXJiLm5wLmVzdGFsZWlyby5zZXJwcm8uZ292LmJyL3JlYWxtcy9tYXN0ZXIiLCJhd WQiOiJhY2NvdW50Iiwic3ViIjoiYmQ1NjU3N2EtYWYyYy00MjFhLWI0YzAtMDFmY2QwM2EzOWRiIiwidHlw IjoiQmVhcmVyIiwiYXpwIjoiOTlmNTRhODMtNmE0Ni00MjRjLWI0MWQtNzQ1ZDQ4NmQxZWRhIiwiYWNy IjoiMSIsInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJkZWZhdWx0LXJvbGVzLW1hc3RlciIsIm9mZmxpbmVfYWNj ZXNzIiwidHJhbnNtaXNzb3IiLCJ1bWFfYXV0aG9yaXphdGlvbiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7ImFjY29 1bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJv ZmlsZSJdfX0sInNjb3BlIjoiZW1haWwgcHJvZmlsZSIsImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwiY2xpZW50SG 9zdCI6IjE3Mi4yMC4xMzMuMTcwIiwiTmktVXN1YXJpbyI6IjAwMDAwMDAwMDAwIiwiY29kaWdvSWJnZSI 6OTk5OTk5OSwicHJlZmVycmVkX3VzZXJuYW1lIjoic2VydmljZS1hY2NvdW50LTk5ZjU0YTgzLTZhNDYtNDI 0Yy1iNDFkLTc0NWQ0ODZkMWVkYSIsImNsaWVudEFkZHJlc3MiOiIxNzIuMjAuMTMzLjE3MCIsImNsaWVu dF9pZCI6Ijk5ZjU0YTgzLTZhNDYtNDI0Yy1iNDFkLTc0NWQ0ODZkMWVkYSJ9.NSdFIgWcc2sOKuKCHOtFg R7HJQe9OT04UI2u5QsaOOqpd-EDsE0k2dU1u-
jvrILA8aqNcRImY5ys6whdj5LWdDIWWcZ99dKvGLhR_wsFVGDQOmc7OEgVdSGFryv2_xHQivD9xuTVDaA dA1i4IQ1YclViG5Gdxpb3L5SrfsOjrdkoxv_nRQ0kpXdtVIV4lnlEEmx5YwUHVBMLt5fDEMMCNO_9iVmOBeq VQ0554jNue6uhXMuVu8AC0NFC30PMk_zxexEOF6h_fYebV_9v1i61B147Elksy1n6beap6noZ37Farrqo2YAb Qh_ecWbUP3wyokA-uDfFGyDoXf-wfmvVgg' \
--form 'arquivo=@"/home/git/sinter/receber-carga-delta/exemploInclusao1000c.zip"'Alteração de uma única UI
⚠️ Esse serviço deve ser utilizado para alteração de uma única UI, caso seja necessário alterar mais de uma UI, deve-se utilizar o serviço de alteração de múltiplas UIs.
PUT /api/v1/{codigoIbge}/ui/{cib} HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Content-Type: application/ndjson
Accept: application/jsonCorpo da Requisição:
json
{
"DadosGeraisImovel": {
"inscricaoImobiliaria": "1234567890123456789012310",
"temBairro": true,
"tipoImovel": 3,
"tpArquitetonico": 11,
"destinacaoImovel": 2,
"idParcela": "PARC-12345679",
"areaTerreno": 350.75,
"areaConstruida": 120.5,
"bice": 1,
"anoConstrutivo": 2005,
"valorVenal": 450000,
"dtUltimoValorVenal": "2024-12-01",
"padraoConstrutivo": 3,
"qtdGaragem": 2,
"temPiscina": false,
"valorRefMercado": 520000,
"dataUltVlrMercado": "2024-12-15"
},
"AreaConstruidaCompl": {
"areaPrivativa": 100.25,
"areaComum": 20.25,
"fraIdeal": 0.5
},
"EnderecoImovel": {
"tipoLogradouro": 100,
"nomeLogradouro": "Avenida Brasil 5",
"bairro": "Centro",
"cep": "70040900",
"numeroImovel": "1234",
"complNroImovel": "BL A",
"complEndereco": "APT 201"
},
"Titular": [
{
"niTitular": "12345678901",
"nomeTitular": "JOAO DA SILVA SANTOS",
"percTitularidade": 0.3,
"dtAquisicaoTitular": "2023-05-20",
"docTitularidade": 1,
"tipoTitularidade": 1
},
{
"niTitular": "12345678901",
"nomeTitular": "RICARDO HELENO BRITO",
"percTitularidade": 0.7,
"dtAquisicaoTitular": "2024-05-20",
"docTitularidade": 1,
"tipoTitularidade": 1
}
],
"ServicoRegistroImovel": {
"nomeServentiaRI": "CARTORIO REGISTRO GERAL",
"cnsRI": 123456,
"cnmRI": 789012,
"numMatriculaRI": "MAT123456789",
"numUltimoAtoRI": "9876543",
"lvCartRI": "LV01",
"flCartRI": "FL02",
"dtUltAtualizacao": "2024-11-30"
},
"CartorioNotas": {
"nomeServentiaNotas": "CARTORIO NOTAS CENTRAL",
"cnsNotas": 555555,
"lvCartNotas": "LN01",
"flCartNotas": "FL01"
},
"ITBI": {
"baseCalculITBI": 500000,
"dtTransacaoITBI": "2024-10-10",
"tpTransacaoITBI": 1,
"percTransacionadoITBI": 1,
"TransmitenteITBI": [
{
"nomeTransmitenteITBI": "MARIA PEREIRA JOIA",
"idTransmitenteITBI": "12345678901234"
},
{
"nomeTransmitenteITBI": "PABLO RAMOS",
"idTransmitenteITBI": "12345678901254"
}
],
"AdquirenteITBI": [
{
"nomeAdquirenteITBI": "JOAO DA SILVA",
"idAdquirenteITBI": "12345678901",
"percTransacAdquirenteITBI": 0.5
},
{
"nomeAdquirenteITBI": "PAULO RAFAEL",
"idAdquirenteITBI": "12345678901",
"percTransacAdquirenteITBI": 0.5
}
],
"valorRefITBI": 700000
}
}Resposta:
json
{
"id": 2,
"uiAlterada": {
"inscricaoImobiliaria": "1234567890123456789012310",
"cib": {
"valor": "WbFTo3zi",
"situacao": "Ativo"
},
"refUi": "https://api.receitafederal.gov.br/prr-sinter/api/v1/ui/{cib}"
},
"camposInvalidos": [],
"mensagem": "UI alterada com Sucesso"
}⚠️ HTTP 429 (Too Many Requests) — em caso de exaustão de conexões ou instabilidade temporária, este serviço pode retornar HTTP 429. Nesse cenário, utilize um dos fluxos em lote: Serviço de Alteração de múltiplas UIs (ndJSON síncrono) ou Serviço de recepção de UI’s por arquivo (arquivo .zip assíncrono). Detalhes em Tratamento de HTTP 429 (Too Many Requests).
Alteração de múltiplas UIs
⚠️ Esse serviço deve ser utilizado para alteração de múltiplas UIs e cada chamada deve conter, no máximo, 200 UI's
PUT /api/v1/{codigoIbge}/uis HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Content-Type: application/ndjson
Accept: application/jsonCorpo da Requisição:
json
{"cib":"MFA64C2P","DadosGeraisImovel":{"inscricaoImobiliaria":"1234567890123456789012391","temBairro":true,"tipoImovel":3,"tpArquitetonico":11,"destinacaoImovel":2,"idParcela":"PARC-12345","areaTerreno":350.75,"areaConstruida":120.5,"bice":1,"anoConstrutivo":2005,"valorVenal":450000,"dtUltimoValorVenal":"2024-12-01","padraoConstrutivo":3,"qtdGaragem":2,"temPiscina":false,"valorRefMercado":520000,"dataUltValorMercado":"2024-12-15"},"AreaConstruidaCompl":{"areaPrivativa":100.25,"areaComum":20.25,"fraIdeal":0.5},"EnderecoImovel":{"tipoLogradouro":100,"nomeLogradouro":"Avenida Brasil","bairro":"Centro","cep":"70040900","numeroImovel":"1234","complNroImovel":"BLA","complEndereco":"APT 201"},"Titular":[{"niTitular":"12345678901","nomeTitular":"JOAO DA SILVA LIMA RAMOS","percTitularidade":1,"dtAquisicaoTitular":"2023-05-20","docTitularidade":1,"tipoTitularidade":1}],"ServicoRegistroImovel":{"nomeServentiaRI":"CARTORIO REGISTRO GERAL","cnsRI":123456,"cnmRI":789012,"numMatriculaRI":"MAT123456789","numUltimoAtoRI":"ATO987","lvCartRI":"LV01","flCartRI":"FL02","dtUltAtualizacao":"2024-11-30"},"CartorioNotas":{"nomeServentiaNotas":"CARTORIO NOTAS CENTRAL","cnsNotas":555555,"lvCartNotas":"LN01","flCartNotas":"FL01"},"ITBI":{"baseCalculITBI":500000,"dtTransacaoITBI":"2024-10-10","tpTransacaoITBI":1,"percTransacionadoITBI":1,"TransmitenteITBI":[{"nomeTransmitenteITBI":"MARIA PEREIRA","idTransmitenteITBI":"12345678901234"}],"AdquirenteITBI":[{"nomeAdquirenteITBI":"JOAO DA SILVA01","percTransacAdquirenteITBI":1}],"valorRefITBI":500000}}
{"cib":"PSV5VXBR","DadosGeraisImovel":{"inscricaoImobiliaria":"1234567890123456789012392","temBairro":true,"tipoImovel":3,"tpArquitetonico":11,"destinacaoImovel":2,"idParcela":"PARC-12345","areaTerreno":350.75,"areaConstruida":120.5,"bice":1,"anoConstrutivo":2005,"valorVenal":450000,"dtUltimoValorVenal":"2024-12-01","padraoConstrutivo":3,"qtdGaragem":2,"temPiscina":false,"valorRefMercado":520000,"dataUltValorMercado":"2024-12-15"},"AreaConstruidaCompl":{"areaPrivativa":100.25,"areaComum":20.25,"fraIdeal":0.5},"EnderecoImovel":{"tipoLog":100,"nomeLogradouro":"Avenida Brasil","bairro":"Centro","cep":"70040900","numeroImovel":"1234","complNroImovel":"BLA","complEndereco":"APT 201"},"Titular":[{"niTitular":"12345678901","nomeTitular":"JOAO DA SILVA PLINIO BRITO","percTitularidade":1,"dtAquisicaoTitular":"2023-05-20","docTitularidade":1,"tipoTitularidade":1}],"ServicoRegistroImovel":{"nomeServentiaRI":"CARTORIO REGISTRO GERAL","cnsRI":123456,"cnmRI":789012,"numMatriculaRI":"MAT123456789","numUltimoAtoRI":"ATO987","lvCartRI":"LV01","flCartRI":"FL02","dtUltAtualizacao":"2024-11-30"},"CartorioNotas":{"nomeServentiaNotas":"CARTORIO NOTAS CENTRAL","cnsNotas":555555,"lvCartNotas":"LN01","flCartNotas":"FL01"},"ITBI":{"baseCalculITBI":500000,"dtTransacaoITBI":"2024-10-10","tpTransacaoITBI":1,"percTransacionadoITBI":1,"TransmitenteITBI":[{"nomeTransmitenteITBI":"MARIA PEREIRA","idTransmitenteITBI":"12345678901234"}],"AdquirenteITBI":[{"nomeAdquirenteITBI":"JOAO DA SILVA","idAdquirenteITBI":"12345678901","percTransacAdquirenteITBI":1}],"valorRefITBI":500000}}
{"DadosGeraisImovel":{"temBairro":true,"tipoImovel":3,"tpArquitetonico":11,"destinacaoImovel":2,"idParcela":"PARC-12345","areaTerreno":350.75,"areaConstruida":120.5,"bice":1,"anoConstrutivo":2005,"valorVenal":450000,"dtUltimoValorVenal":"2024-12-01","padraoConstrutivo":3,"qtdGaragem":2,"temPiscina":false,"valorRefMercado":520000,"dataUltValorMercado":"2024-12-15"},"AreaConstruidaCompl":{"areaPrivativa":100.25,"areaComum":20.25,"fraIdeal":0.5},"EnderecoImovel":{"tipoLogradouro":100,"nomeLogradouro":"Avenida Brasil","bairro":"Centro","cep":"70040900","numeroImovel":"1234","complNroImovel":"BLA","complEndereco":"APT 201"},"Titular":[{"niTitular":"12345678901","nomeTitular":"JOAO DA SILVA","percTitularidade":1,"dtAquisicaoTitular":"2023-05-20","docTitularidade":1,"tipoTitularidade":1}],"ServicoRegistroImovel":{"nomeServentiaRI":"CARTORIO REGISTRO GERAL","cnsRI":123456,"cnmRI":789012,"numMatriculaRI":"MAT123456789","numUltimoAtoRI":"ATO987","lvCartRI":"LV01","flCartRI":"FL02","dtUltAtualizacao":"2024-11-30"},"CartorioNotas":{"nomeServentiaNotas":"CARTORIO NOTAS CENTRAL","cnsNotas":555555,"lvCartNotas":"LN01","flCartNotas":"FL01"},"ITBI":{"baseCalculITBI":500000,"dtTransacaoITBI":"2024-10-10","tpTransacaoITBI":1,"percTransacionadoITBI":1,"TransmitenteITBI":[{"nomeTransmitenteITBI":"MARIA PEREIRA","idTransmitenteITBI":"12345678901234"}],"AdquirenteITBI":[{"nomeAdquirenteITBI":"JOAO DA SILVA","idAdquirenteITBI":"12345678901","percTransacAdquirenteITBI":1}],"valorRefITBI":500000}}Resposta
json
[
{
"id": 2,
"uiAlterada": null,
"camposInvalidos": [
{
"campo": "dadosGeraisImovel.inscricaoImobiliaria",
"erro": "Campo obrigatório não preenchido: ",
"idFalha": "0001"
}
],
"mensagem": "Município: Belo Horizonte, Código IBGE: 3106200, Inscrição Imobiliária: null. Não foi possível atribuir CIB. Campos obrigatórios não informados ou informados inválidos."
},
{
"id": 2,
"uiAlterada": {
"inscricaoImobiliaria": "1234567890123456789012391",
"cib": {
"valor": "MFA64C2P",
"situacao": "Ativa"
},
"refUi": "http://api.receitafederal.gov.br/prr-sinter/api/v1/ui/MFA64C2P"
},
"camposInvalidos": [
{
"campo": "adquirenteITBIDTO.idAdquirenteITBI",
"erro": "",
"idFalha": "0106"
},
{
"campo": "servicoRegistroImovel.cnmRI",
"erro": "apenas números, 15 ou 16 dígitos",
"idFalha": "0102"
},
{
"campo": "titular.niTitular",
"erro": "",
"idFalha": "0106"
},
{
"campo": "transmitentesITBI.idTransmitenteITBI",
"erro": "",
"idFalha": "0106"
}
],
"mensagem": null
},
{
"id": 2,
"uiAlterada": {
"inscricaoImobiliaria": "1234567890123456789012392",
"cib": {
"valor": "PSV5VXBR",
"situacao": "Ativa"
},
"refUi": "http://api.receitafederal.gov.br/prr-sinter/api/v1/ui/PSV5VXBR"
},
"camposInvalidos": [
{
"campo": "adquirenteITBIDTO.idAdquirenteITBI",
"erro": "",
"idFalha": "0106"
},
{
"campo": "servicoRegistroImovel.cnmRI",
"erro": "apenas números, 15 ou 16 dígitos",
"idFalha": "0102"
},
{
"campo": "titular.niTitular",
"erro": "",
"idFalha": "0106"
},
{
"campo": "transmitentesITBI.idTransmitenteITBI",
"erro": "",
"idFalha": "0106"
}
],
"mensagem": null
},
{
"id": 2,
"uiAlterada": null,
"camposInvalidos": [
{
"campo": "adquirenteITBIDTO.idAdquirenteITBI",
"erro": "",
"idFalha": "0106"
},
{
"campo": "servicoRegistroImovel.cnmRI",
"erro": "apenas números, 15 ou 16 dígitos",
"idFalha": "0102"
},
{
"campo": "titular.niTitular",
"erro": "",
"idFalha": "0106"
},
{
"campo": "transmitentesITBI.idTransmitenteITBI",
"erro": "",
"idFalha": "0106"
}
],
"mensagem": "Não foi possível alterar UI"
}
]Desativação de uma única UI
⚠️ Esse serviço deve ser utilizado para desativação de uma única UI, caso seja necessário desativar mais de uma UI, deve-se utilizar o serviço de desativação de múltiplas UIs.
PUT /api/v1/{codigoIbge}/ui/desativacao HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonCorpo da Requisição:
json
{"inscricaoImobiliaria": "1234567890123456789012346", "cib": "Z52QM6SX", "tipoDesativacao": 2,"motivoDesativacao": 10, "complemento": "texto"}Resposta:
json
{"id": 3, "uiDesativada": { "cib": { "situacao": "Extinta", "valor": "Z52QM6SX" },"inscricaoImobiliaria": "1234567890123456789012346", "refUi": "https://api.receitafederal.gov.br/prr-sinter/api/v1/ui/{cib}" }, "camposInvalidos": [], "mensagem": "UI Desativada com sucesso",}⚠️ HTTP 429 (Too Many Requests) — em caso de exaustão de conexões ou instabilidade temporária, este serviço pode retornar HTTP 429. Nesse cenário, utilize um dos fluxos em lote: Serviço de Desativação de múltiplas UIs (ndJSON síncrono) ou Serviço de recepção de UI’s por arquivo (arquivo .zip assíncrono). Detalhes em Tratamento de HTTP 429 (Too Many Requests).
Desativação de múltiplas UIs
⚠️ Esse serviço deve ser utilizado para desativação de múltiplas UIs e cada chamada deve conter, no máximo, 200 elementos de UI
PUT /v1/{codigoIbge}/uis/desativacao HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonCorpo da Requisição:
json
{"codigoIbgeMunicipio":4314902,"inscricaoImobiliaria":"_ 1234567890123456789012346 _","cib":"STH4 041P","tipoDesativacao":2,"motivoDesativacao":9,"complemento":"texto"} {"codigoIbgeMunicipio":4314902,"inscricaoImobiliaria":"_ 1234567890123456789012347 _","cib":"75T5 PPDR","tipoDesativacao":1,"motivoDesativacao":5}Resposta
json
[
{
"id": 1,
"uiDesativada": {
"cib": {
"situacao": "Extinta",
"valor": " _STH4041P_ "
},
"inscricaoImobiliaria": "1234567890123456789012346",
"refUi": "https://api.receitafederal.gov.br/prr-sinter/api/v1/ui/{cib}"
},
"camposInvalidos": [],
"mensagem": "UI Desativada com sucesso"
},
{
"id": 2,
"uiDesativada": {
"cib": {
"situacao": "Extinta",
"valor": " _75T5PPDR_ "
},
"inscricaoImobiliaria": "1234567890123456789012347",
"refUi": "https://api.receitafederal.gov.br/prr-sinter/api/v1/ui/{cib}"
},
"camposInvalidos": [],
"mensagem": "UI Desativada com sucesso"
}
]Consultar processamento e falhas
GET /api/v1/{codigoIbge}/arquivo/{idArquivo}/consulta HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonPossíveis Parâmetros da consulta:
Obs.: Os parâmetros serão passados na própria URL, usando o método Query Parameters
| Nome do Campo | Descrição | Tipo | Validações / Valor padrão |
|---|---|---|---|
| idArquivo | Identificad or do Arquivo | Texto | Obrigatório. O usuário deve ter acesso de consulta para o município da requisição. |
| inscricaoImobiliaria | Inscrição Imobiliária | Texto | Opcional. Se informado, não pode ser informado cib. O código IBGE é o da requisição, então só é informada a Inscrição Imobiliária. |
| cib | CIB (Cadastro Imobiliário Brasileiro) | Texto | Opcional. Se informado, não pode ser informada inscricaoImobili aria. |
| pagina | Página a ser obtida | Inteiro | Opcional. Valor padrão =1. |
| qtdeRegistrosPagin a | Quantidad e de registros que devem ser retornados por página | Inteiro | Opcional. Valor padrão =___ (preencher). Valor máximo = ___(preencher). |
| efetivados | Indicador de consulta dos registros efetivados | Booleano | Opcional. Valor padrão =true. |
| rejeitados | Indicador de consulta dos registros rejeitados | Booleano | Opcional. Valor padrão =true. |
| obterPayload | Indicador para retornar payload dos registros | Booleano | Opcional. Valor padrão =false. |
| operacao | Operação realizada de cada registro | Letra | Opcional. Valor padrão = nenhum (consulta todas as operações, inclusive registros que não têm operação válida). Opções válidas: I,A,D (inclusão, alteração, desativação). |
| listarFalhas | Listar falhas ocorridas para cada registro | Booleano | Opcional. Valor padrão =true. |
| codigoFalha | Código das falhas a serem consultad as | Texto (4 dígitos) | Opcional, só pode ser informado se listarFalhas = true. Se informado, só serão retornados registros que contenham falha desse tipo. |
| campoFalha | Nome do campo com falha | Texto | Opcional,só podeser informado se listarFalhas = true. Se informado, só serão retornados registros que contenham falha relacionada a esse campo. Os nomes dos campos são os previstos na regra 951287:RN - Atributos Unidade Imobiliária Urbana. |
| ordenarPor | Nome do campo e direção da ordenação | Texto | Opcional. Pode ser informado mais de uma vez para ordenar por mais de um campo (prioridade = ordem de declaração) . Formato: ordenarPor=nomeCampo, direcao. Valores válidos para nomeCampo: cib, inscricaoImobiliaria. Valores válidos para direcao: asc, desc |
Resposta:
json
{
"codigoIbgeMunicipio": 4314902,
"dataHoraRequisicao": "2025-11-17 16:58:42",
"listaRequisicoes": [
4294,
4295,
4296,
4298,
4302,
4306,
4310,
4297,
4299,
4303,
4307,
4311,
4300,
4304,
4308,
4312,
4301,
4305,
4309,
4313,
4314,
4316,
4318,
4320,
4315,
4317,
4319,
4321,
4285,
4287,
4290,
4283,
4288,
4291,
4284,
4286,
4292,
4282,
4289,
4293
],
"pagina": 1,
"qtdeRegistrosPagina": 20,
"qtdeRegistrosTotal": 349,
"registros": [
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000003000967223889",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000002000203505099",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000001000014374891",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000003010781771641",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000002010854669635",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000001010647829916",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000000040397093881",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000001020585131145",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000002020940930940",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000003040472351400",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000000060774211408",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000002050191033666",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000003060648536768",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000001060906030697",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000000080396758212",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000003080110922242",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000001080599030074",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000000120232958220",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000001100043939583",
"operacao": "Inclusão"
},
{
"efetivado": false,
"falhas": [
{
"camposFalha": "dadosGeraisImovel.tpArquitetonico, dadosGeraisImovel.areaConstruida, dadosGeraisImovel.tipoImovel",
"codigoFalha": "0011"
}
],
"inscricaoImobiliaria": "0000000000002130221738012",
"operacao": "Inclusão"
}
],
"ultimaPagina": false
}OBS.: Para fins de ilustração, segue exemplo da consulta usando a ferramenta curl:
bash
curl -X 'GET' \ 'https://api.receitafederal.gov.br/prr-sinter/api/v1/4314902/arquivo/4314902_1763401799631/consulta?pagina=1&qtdePorPagina=20' \ -H 'accept: _/_ ' \ -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJvWTNuN0trMWJyUnBhVnZVQTBob0V6d0lXZjV 5VkI4TWtIVHUwclpzT0F3In0.eyJleHAiOjE3NjM0MTAzODYsImlhdCI6MTc2MzQwOTQ4NiwianRpIjoid HJydGNjOjU5ODRkYzkyLTgzZjAtNDc2Yy1hYmIwLWM4MWIzZjAyYTc4YiIsImlzcyI6Imh0dHBzOi8vZG VzLWtleWNsb2NrLXNpbnRlcjItY2FkdXJibC5ucC5lc3RhbGVpcm8uc2VycHJvLmdvdi5ici9yZWFsbcy9t YXN0ZXIiLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiYmQ1NjU3N2EtYWYyYy00MjFhLWI0YzAtMDFmY2Qw M2EzOWRiIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoiOTlmNTRhODMtNmE0Ni00MjRjLWI0MWQtNzQ1ZD Q4NmQxZWRhIiwiYWNyIjoiMSIsInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJkZWZhdWx0LXJvbGVzLW1hc 3RlciIsIm9mZmxpbmVfYWNjZXNzIiwidHJhbnNtaXNzb3IiLCJ1bWFfYXV0aG9yaXphdGlvbiJdfSwicmVz b3VyY2VfYWNjZXNzIjp7ImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtY WNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX0sInNjb3BlIjoiZW1haWwgcHJvZmlsZSIsImVtYWlsX 3ZlcmVpZmllZCI6ZmFsc2UsImNsaWVudEhvc3QiOiIxNzIuMjAuMTMzLjE3MCIsIk5pLVVzdWFyaW8iOiIj AwMDAwMDAwMDAwIiwiY29kaWdvSWJnZSI6OTk5OTk5OSwicHJlZmVycmVkX3VzZXJuYW1lIjoic2Vy dmljZS1hY2NvdW50LTk5ZjU0YTgzLTZhNDYtNDI0Yy1iNDFkLTc0NWQ0ODZkMWVkYSIsImNsaWVu dEFkZHJlc3MiOiIxNzIuMjAuMTMzLjE3MCIsImNsaWVudF9pZCI6Ijk5ZjU0YTgzLTZhNDYtNDI0Yy1iND FkLTc0NWQ0ODZkMWVkYSJ9.YoyBjjQVdl1WcnnXhR4Krbk5VcBFDi3vvVTb5lOupPfaCGH_1ekpc0gv Gcs4UKUyGyPEbSdBWTzRRQiOQoz1htaBSrGTT7mXm0juZThTXKlG0LvdS31lzXo4S1cUKncZFPbLm d0juZdtFrcNqRn8Hsqua0R-
_D_k8e_k8zJ9IzHNW4GSaZw5SfoCOSvAv6sF3_kVlrvqZkMMHeclnVE0pG7aJ75yTjYMyaPlnajYGhQItJ gUA0OsHQNDEAWvFqHRFGuM6_d8NlhfUnlYTGc9gLYpQs7cW9Kb6OFTf1nwxwQ57LcScEBltEdZL6 Y71cKEjLUsADkKN15qvojnigCI6w'Consultar uma única UI por CIB
GET /api/v1/ui/{cib} HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonResposta:
json
{
"InfoIbge": {
"nomeMunicipio": "Belo Horizonte",
"siglaUf": "MG",
"codigoIbge": 3106200
},
"Cib": {
"valor": "CJNJJ50G",
"situacao": "Ativa"
},
"DadosGeraisImovel": {
"inscricaoImobiliaria": "1234567890123456789012310",
"tipoImovel": 3,
"tpArquitetonico": 11,
"destinacaoImovel": 2,
"idParcela": "PARC-123456",
"areaTerreno": 350.75,
"areaConstruida": 120.5,
"bice": 1,
"anoConstrutivo": 2005,
"valorVenal": 450000,
"dtUltimoValorVenal": "2024-12-01",
"padraoConstrutivo": 3,
"qtdGaragem": 2,
"temPiscina": false,
"valorRefMercado": 520000,
"temBairro": true,
"dataUltVlrMercado": "2024-12-15"
},
"AreaConstruidaCompl": {
"areaPrivativa": 100.25,
"areaComum": 20.25,
"fraIdeal": 0.5
},
"EnderecoImovel": {
"tipoLogradouro": 100,
"nomeLogradouro": "Avenida Brasil",
"bairro": "Centro",
"cep": "70040900",
"numeroImovel": "1234",
"complNroImovel": "BL A",
"complEndereco": "APT 201"
},
"Titular": [
{
"niTitular": null,
"nomeTitular": "JOAO DA SILVA",
"percTitularidade": 1,
"dtAquisicaoTitular": "2023-05-20",
"docTitularidade": 1,
"tipoTitularidade": 1,
"nomeValido": true,
"niTitularPrenchidoCorretamente": false,
"dvniTitularValido": false
}
],
"ServicoRegistroImovel": {
"nomeServentiaRI": "CARTORIO REGISTRO GERAL",
"cnsRI": 123456,
"cnmRI": null,
"numMatriculaRI": "MAT123456789",
"numUltimoAtoRI": "9876543",
"lvCartRI": "LV01",
"flCartRI": "FL02",
"dtUltAtualizacao": "2024-11-30"
},
"CartorioNotas": {
"nomeServentiaNotas": "CARTORIO NOTAS CENTRAL",
"cnsNotas": 555555,
"lvCartNotas": "LN01",
"flCartNotas": "FL01"
},
"ITBI": {
"baseCalculITBI": 500000,
"dtTransacaoITBI": "2024-10-10",
"tpTransacaoITBI": 1,
"percTransacionadoITBI": 1,
"valorRefITBI": 500000,
"TransmitenteITBI": [
{
"nomeTransmitenteITBI": "MARIA PEREIRA",
"idTransmitenteITBI": null,
"dvvalidNi": false,
"idTransmitentePreenchidoCorretamente": false,
"nomeTransmitenteValido": true
}
],
"AdquirenteITBI": [
{
"nomeAdquirenteITBI": "JOAO DA SILVA",
"idAdquirenteITBI": null,
"percTransacAdquirenteITBI": 1,
"percTransacAdquirenteITBIValido": true,
"nomeAdquirenteValido": true,
"idAdquirentePreenchidoCorretamente": false,
"dvvalidNi": false
}
]
}
}Consultar uma única UI por Código Ibge e Inscricao
GET /api/v1/{codigoIbge}/ui/{inscricaoImobiliaria} HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonResposta:
json
{
"InfoIbge": {
"nomeMunicipio": "Belo Horizonte",
"siglaUf": "MG",
"codigoIbge": 3106200
},
"Cib": {
"valor": "CJNJJ50G",
"situacao": "Ativa"
},
"DadosGeraisImovel": {
"inscricaoImobiliaria": "1234567890123456789012310",
"tipoImovel": 3,
"tpArquitetonico": 11,
"destinacaoImovel": 2,
"idParcela": "PARC-123456",
"areaTerreno": 350.75,
"areaConstruida": 120.5,
"bice": 1,
"anoConstrutivo": 2005,
"valorVenal": 450000,
"dtUltimoValorVenal": "2024-12-01",
"padraoConstrutivo": 3,
"qtdGaragem": 2,
"temPiscina": false,
"valorRefMercado": 520000,
"temBairro": true,
"dataUltVlrMercado": "2024-12-15"
},
"AreaConstruidaCompl": {
"areaPrivativa": 100.25,
"areaComum": 20.25,
"fraIdeal": 0.5
},
"EnderecoImovel": {
"tipoLogradouro": 100,
"nomeLogradouro": "Avenida Brasil",
"bairro": "Centro",
"cep": "70040900",
"numeroImovel": "1234",
"complNroImovel": "BL A",
"complEndereco": "APT 201"
},
"Titular": [
{
"niTitular": null,
"nomeTitular": "JOAO DA SILVA",
"percTitularidade": 1,
"dtAquisicaoTitular": "2023-05-20",
"docTitularidade": 1,
"tipoTitularidade": 1,
"nomeValido": true,
"niTitularPrenchidoCorretamente": false,
"dvniTitularValido": false
}
],
"ServicoRegistroImovel": {
"nomeServentiaRI": "CARTORIO REGISTRO GERAL",
"cnsRI": 123456,
"cnmRI": null,
"numMatriculaRI": "MAT123456789",
"numUltimoAtoRI": "9876543",
"lvCartRI": "LV01",
"flCartRI": "FL02",
"dtUltAtualizacao": "2024-11-30"
},
"CartorioNotas": {
"nomeServentiaNotas": "CARTORIO NOTAS CENTRAL",
"cnsNotas": 555555,
"lvCartNotas": "LN01",
"flCartNotas": "FL01"
},
"ITBI": {
"baseCalculITBI": 500000,
"dtTransacaoITBI": "2024-10-10",
"tpTransacaoITBI": 1,
"percTransacionadoITBI": 1,
"valorRefITBI": 500000,
"TransmitenteITBI": [
{
"nomeTransmitenteITBI": "MARIA PEREIRA",
"idTransmitenteITBI": null,
"dvvalidNi": false,
"idTransmitentePreenchidoCorretamente": false,
"nomeTransmitenteValido": true
}
],
"AdquirenteITBI": [
{
"nomeAdquirenteITBI": "JOAO DA SILVA",
"idAdquirenteITBI": null,
"percTransacAdquirenteITBI": 1,
"percTransacAdquirenteITBIValido": true,
"nomeAdquirenteValido": true,
"idAdquirentePreenchidoCorretamente": false,
"dvvalidNi": false
}
]
}
}Consultar requisição com registros efetivados e rejeitados
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonResposta
json
{
"idRequisicao": 425,
"codigoIbgeMunicipio": 3106200,
"dataHoraRequisicao": "2025-10-25 09:42:11",
"qtdeRegistrosTotal": 2,
"qtdeRegistrosPagina": 20,
"pagina": 1,
"ultimaPagina": true,
"registro s": [
{
"operacao": "Inclusão",
"efetivado": false,
"falhas": [
{
"codigoFalha": "0004",
"camposFalha": "dadosG eraisImovel.tipoImovel"
}
]
},
{
"inscricaoImobiliaria": "0000000000002970264435404",
"cib": "SCRZ1R3 4",
"operacao": "Inclusão",
"efetivado": true,
"falhas": [
{
"codigoFalha": "0106",
"camposFalha": "adquirent eITBIDTO.idAdquirenteITBI"
},
{
"codigoFalha": "0104",
"camposFalha": "dadosGeraisImovel.tpArquitet onico"
},
{
"codigoFalha": "0103",
"camposFalha": "servicoRegistroImovel.numUltimoAtoRI",
"complemento": "max: 7"
},
{
"codigoFalha": "0106",
"camposFalha": "transmitentesITBI.idTransmitenteITBI"
}
]
}
]
}Consultar apenas os registros efetivados
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?efetivados=true&rejeitados=false&pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonResposta
json
{
"idRequisicao": 425,
"codigoIbgeMunicipio": 3106200,
"dataHoraRequisicao": "2025-10-25 09:44:07",
"qtdeRegistrosTotal": 1,
"qtdeRegistrosPagina": 20,
"pagina": 1,
"ultimaPagina": true,
"registro s": [
{
"inscricaoImobiliaria": "0000000000002970264435404",
"cib": "SCRZ1R34",
"operacao": "Inclusão ",
"efetivado": true,
"falhas": [
{
"codigoFalha": "0106",
"camposFalha": "adquirenteITBIDTO.idAdquirenteI TBI"
},
{
"codigoFalha": "0104",
"camposFalha": "dadosGeraisImovel.tpArquitetonico"
},
{
"codigoFalha": "0 103",
"camposFalha": "servicoRegistroImovel.numUltimoAtoRI",
"complemento": "max:7"
},
{
"codigoFalha": "0106",
"camposFalha": "transmitentesITBI.idTransmitenteITBI"
}
]
}
]
}Consultar apenas os registros rejeitados
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?efetivados=false&rejeitados=true&pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonResposta
json
{"idRequisicao":425,"codigoIbgeMunicipio":3106200,"dataHoraRequisicao":"2025-10-25 09:44:31","qtdeRegistrosTotal":1,"qtdeRegistrosPagina":20,"pagina":1,"ultimaPagina":true,"registro s":[{"operacao":"Inclusão","efetivado":false,"falhas":[{"codigoFalha":"0004","camposFalha":"dadosG eraisImovel.tipoImovel"}]}]}Consultar payloads dos registros
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?obterPayload=true&pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonResposta
json
{
"idRequisicao": 425,
"codigoIbgeMunicipio": 3106200,
"dataHoraRequisicao": "2025-10-25 09:44:57",
"qtdeRegistrosTotal": 2,
"qtdeRegistrosPagina": 20,
"pagina": 1,
"ultimaPagina": true,
"registro s": [
{
"operacao": "Inclusão",
"efetivado": false,
"falhas": [
{
"codigoFalha": "0004",
"camposFalha": "dadosG eraisImovel.tipoImovel"
}
],
"payload": {
"DadosGeraisImovel": {
"inscricaoImobiliaria": "0000000000006 000070242191",
"tipoImovel": 7,
"tipoImovelDescricao": null,
"tpArquitetonico": 11,
"tpArquitetonicoDe scricao": null,
"destinacaoImovel": 9,
"destinacaoImovelDescricao": null,
"idParcela": "PARC-67184",
"areaTerreno": 263.35,
"areaConstruida": 607.5,
"bice": 7,
"biceDescricao": null,
"anoConstrutivo ": 1998,
"valorVenal": 341619.68,
"dtUltimoValorVenal": "2025-10-18",
"padraoConstrutivo": 3,
"padraoConstrutivoDescricao": null,
"qtdGaragem": 1,
"temPiscina": false,
"v alorRefMercado": 355550.95,
"temBairro": true,
"dataUltVlrMercado": "2025-08-29"
},
"AreaConstruidaCompl": {
"areaPrivativa": 168.07,
"areaComum": 41.19,
"fraIdeal": 0.67
},
"Enderec oImovel": {
"tipoLogradouro": 74,
"tipoLogradouroDescricao": null,
"nomeLogradouro": "Ponte Pedro",
"bairro": "Torres Vedras",
"cep": "85176832",
"numeroImovel": "3085",
"complNroImovel": "BL g",
"complEndereco": "APT 672"
},
"Titular": [
{
"niTitular": "64252208211",
"nomeTitular": "SOPHIA DIAS",
"percTitularidade": 1,
"dtAquisicaoTitular": "2025-05-08",
"docTitularidade": 5,
"docTitularidadeDescricao": null,
"tipoTitularidade": 1,
"tipoTitularidadeDescricao": null
}
],
"ServicoRegistroImovel": {
"nomeServentiaRI": "Mendanha-Henriques",
"cnsRI": 280785,
"cnmRI": "3956115843161141",
"numMatriculaRI": "3385738721",
"numU ltimoAtoRI": "33588613",
"lvCartRI": "eh55",
"flCartRI": "qm98",
"dtUltAtualizacao": "2025-04-26"
},
"CartorioNotas": {
"nomeServentiaNotas": "Sais S.A.",
"cnsNotas": 252331,
"lvCartNotas": "ko26",
"flCartNotas": "vu30"
},
"ITBI": {
"baseCalculITBI": 471139.98,
"dtTransacaoITBI": "2024-06-01",
"tpTransacaoITBI": 3,
"tpTransacaoITBIDescricao": null,
"percTransacionadoITBI": 0.34,
"valorRefITB I": 117657.83,
"TransmitenteITBI": [
{
"nomeTransmitenteITBI": "Luiza Rezende",
"idTransmitenteITBI": "80769840274012"
}
],
"AdquirenteITBI": [
{
"nomeAdquirenteITBI": "Carolina Caldeira",
"idAdquirenteITBI": "92753171991",
"percTransacAdquirenteITBI": 0.47
}
]
},
"DadosGeo": null
}
},
{
"inscricaoImobiliaria": "0000000000002970264435404",
"cib": "SCRZ1R34",
"operacao": "Inclusão",
"efetivado": true,
"falhas": [
{
"codigoFalha": "0106",
"camposFalha": "adquirenteITBIDTO.idAdquirenteIT BI"
},
{
"codigoFalha": "0104",
"camposFalha": "dadosGeraisImovel.tpArquitetonico"
},
{
"codigoFalha": "01 03",
"camposFalha": "servicoRegistroImovel.numUltimoAtoRI",
"complemento": "max:7"
},
{
"codigoFalha": "0106",
"camposFalha": "transmitentesITBI.idTransmitenteITBI"
}
],
"payload": {
"Dad osGeraisImovel": {
"inscricaoImobiliaria": "0000000000002970264435404",
"tipoImovel": 3,
"tipoImov elDescricao": null,
"tpArquitetonico": null,
"tpArquitetonicoDescricao": null,
"destinacaoImovel": 2,
"desti nacaoImovelDescricao": null,
"idParcela": "PARC-29288",
"areaTerreno": 699.31,
"areaConstruida": 30.7,
"bice": 2,
"biceDescricao": null,
"anoConstrutivo": 2012,
"valorVenal": 125086,
"dtUltimoValorVenal": "2025-08-24",
"padraoConstrutivo": 3,
"padraoConstrutivoDescricao": null,
"qtdGaragem": 5,
"temPiscina": false,
"v alorRefMercado": 141134.66,
"temBairro": true,
"dataUltVlrMercado": "2025-01-19"
},
"AreaConstruidaCompl": {
"areaPrivativa": 296.26,
"areaComum": 154.11,
"fraIdeal": 0.49
},
"Endere coImovel": {
"tipoLogradouro": 142,
"tipoLogradouroDescricao": null,
"nomeLogradouro": "Rodovia Luna Pires",
"bairro": "Águeda",
"cep": "43526963",
"numeroImovel": "2868",
"complNroImovel": "BL b",
"complEndereco": "APT 599"
},
"Titular": [
{
"niTitular": "26370828602",
"nomeTitular": "DR. MIGUEL APARÍCIO",
"percTitularidade": 1,
"dtAquisicaoTitular": "2024-06-16",
"docTitularidade": 2,
"docTitularidadeDescricao": null,
"tipoTitularidade": 1,
"tipoTitularidadeDescri cao": null
}
],
"ServicoRegistroImovel": {
"nomeServentiaRI": "de Quadros-da Luz",
"cnsRI": 617762,
"cnmRI": "0511071893755702",
"numMatriculaRI": "7463053203",
"numUltimoA toRI": null,
"lvCartRI": "pa67",
"flCartRI": "od78",
"dtUltAtualizacao": "2025-06- 01"
},
"CartorioNotas": {
"nomeServentiaNotas": "Viana Comércio",
"cnsNotas": 818288,
"lvCartNotas": "gk52",
"flCartNotas": "gs54"
},
"ITBI": {
"baseCalculITBI": 484963.08,
"dtTransacaoITBI": "2024-09-16",
"tpTransacaoITBI": 5,
"tpTransacaoITBIDescricao": null,
"percTransacionadoITBI": 0.69,
"valorRefITB I": 277422.79,
"TransmitenteITBI": [
{
"nomeTransmitenteITBI": "Ana Ramires",
"idTransmitenteITBI": null
}
],
"AdquirenteITBI": [
{
"nomeAdquirenteITBI": "Ana Laura Camacho S.A.",
"idAdquirenteITBI": null,
"percTransacAdquirenteITBI": 0.95
}
]
},
"DadosGeo": null
}
}
]
}Consultar para filtrar o tipo de operação
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?operacao={tipoOperacao}&pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonOBS. Ver domínio Tipos de Operação
Resposta
json
{"idRequisicao":425,"codigoIbgeMunicipio":3106200,"dataHoraRequisicao":"2025-10-25 09:45:32","qtdeRegistrosTotal":2,"qtdeRegistrosPagina":20,"pagina":1,"ultimaPagina":true,"registro s":[{"operacao":"Inclusão","efetivado":false,"falhas":[{"codigoFalha":"0004","camposFalha":"dadosG eraisImovel.tipoImovel"}]},{"inscricaoImobiliaria":"0000000000002970264435404","cib":"SCRZ1R3 4","operacao":"Inclusão","efetivado":true,"falhas":[{"codigoFalha":"0106","camposFalha":"adquirent eITBIDTO.idAdquirenteITBI"},{"codigoFalha":"0104","camposFalha":"dadosGeraisImovel.tpArquitet onico"},{"codigoFalha":"0103","camposFalha":"servicoRegistroImovel.numUltimoAtoRI","compleme nto":"max: 7"},{"codigoFalha":"0106","camposFalha":"transmitentesITBI.idTransmitenteITBI"}]}]}Se não houverem resultados a ser retornados, a resposta será assim:
json
{"idRequisicao":425,"codigoIbgeMunicipio":3106200,"dataHoraRequisicao":"2025-10-25 09:45:48","qtdeRegistrosTotal":0,"qtdeRegistrosPagina":20,"pagina":1,"ultimaPagina":true,"registro s":[]}Consultar sem apresentar as falhas do registro
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?listarFalhas=false&pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonResposta
json
{"idRequisicao":425,"codigoIbgeMunicipio":3106200,"dataHoraRequisicao":"2025-10-25 09:51:24","qtdeRegistrosTotal":2,"qtdeRegistrosPagina":20,"pagina":1,"ultimaPagina":true,"registro s":[{"operacao":"Inclusão","efetivado":false},{"inscricaoImobiliaria":"0000000000002970264435404 ","cib":"SCRZ1R34","operacao":"Inclusão","efetivado":true}]}Consultar registros por código de falha
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?codigoFalha={codigoFalha}&pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonOBS. Ver domínio Códigos de Falhas
Resposta
json
{"idRequisicao":425,"codigoIbgeMunicipio":3106200,"dataHoraRequisicao":"2025-10-25 09:51:55","qtdeRegistrosTotal":2,"qtdeRegistrosPagina":20,"pagina":1,"ultimaPagina":true,"registro s":[{"inscricaoImobiliaria":"0000000000002970264435404","cib":"SCRZ1R34","operacao":"Inclusão ","efetivado":true,"falhas":[{"codigoFalha":"0106","camposFalha":"adquirenteITBIDTO.idAdquirenteI TBI"},{"codigoFalha":"0106","camposFalha":"transmitentesITBI.idTransmitenteITBI"}]}]}Consultar registros por campo de falha
GET /api/v1/{codigoIbge}/consulta/{idRequisicao}?campoFalha={nomeCampo}&pagina=1&qtdePorPagina=20 HTTP/1.1
Host: api.receitafederal.gov.br/prr-sinter
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...
Accept: application/jsonEx. nomeCampo assumindo o valor: numUltimoAtoRI
Resposta
json
{"idRequisicao":425,"codigoIbgeMunicipio":3106200,"dataHoraRequisicao":"2025-10-25 09:58:25","qtdeRegistrosTotal":2,"qtdeRegistrosPagina":20,"pagina":1,"ultimaPagina":true,"registro s":[{"inscricaoImobiliaria":"0000000000002970264435404","cib":"SCRZ1R34","operacao":"Inclusão ","efetivado":true,"falhas":[{"codigoFalha":"0103","camposFalha":"servicoRegistroImovel.numUltimo AtoRI","complemento":"max: 7"}]}]}Respostas de Erro (exemplos)
| Código | Descrição |
|---|---|
| 400 | Parâmetros inválidos na chamada do serviço ou Parâmetros não informados na chamada do serviço |
| 401 | Token ausente ou expirado |
| 403 | Usuário sem permissão para criar UI |
| 409 | Conflito – UI já existente (mesma inscrição municipal) |
| 500 | Erro interno da API |