Skip to content

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:

FluxoComo funcionaQuando usar
Opção A — Síncrono via ndJSONEnvio 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 compactadoAs 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áriaOpção A — ndJSON síncronoOpção B — arquivo .zip assíncrono
Serviço de Inclusão de uma única UIServiço de Inclusão de múltiplas UIsServiço de recepção de UI’s por arquivo
Alteração de uma única UIAlteração de múltiplas UIsServiço de recepção de UI’s por arquivo
Desativação de uma única UIDesativação de múltiplas UIsServiç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/json

Corpo 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/json

Corpo 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-data

Corpo 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/json

Corpo 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/json

Corpo 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/json

Corpo 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/json

Corpo 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/json

Possíveis Parâmetros da consulta:

Obs.: Os parâmetros serão passados na própria URL, usando o método Query Parameters

Nome do CampoDescriçãoTipoValidações /
Valor padrão
idArquivoIdentificad
or do
Arquivo
TextoObrigatório. O
usuário deve ter
acesso de
consulta para o
município da
requisição.
inscricaoImobiliariaInscrição
Imobiliária
TextoOpcional.
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.
cibCIB
(Cadastro
Imobiliário
Brasileiro)
TextoOpcional.
Se informado,
não pode ser
informada
inscricaoImobili
aria.
paginaPágina a
ser obtida
InteiroOpcional. Valor
padrão =1.
qtdeRegistrosPagin
a
Quantidad
e de
registros
que
devem ser
retornados
por página
InteiroOpcional. Valor
padrão =___
(preencher).
Valor máximo =
___(preencher).
efetivadosIndicador
de
consulta
dos
registros
efetivados
BooleanoOpcional. Valor
padrão =true.
rejeitadosIndicador
de
consulta
dos
registros
rejeitados
BooleanoOpcional. Valor
padrão =true.
obterPayloadIndicador
para
retornar
payload dos
registros
BooleanoOpcional. Valor
padrão =false.
operacaoOperação
realizada
de cada
registro
LetraOpcional. 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).
listarFalhasListar
falhas
ocorridas
para cada
registro
BooleanoOpcional. Valor
padrão =true.
codigoFalhaCó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.
campoFalhaNome do
campo
com falha
TextoOpcional,
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.
ordenarPorNome do
campo e
direção da
ordenação
TextoOpcional. 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/json

Resposta:

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/json

Resposta:

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/json

Resposta

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/json

Resposta

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/json

Resposta

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/json

Resposta

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/json

OBS. 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/json

Resposta

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/json

OBS. 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/json

Ex. 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ódigoDescrição
400Parâmetros inválidos na chamada do serviço ou Parâmetros não
informados na chamada do serviço
401Token ausente ou expirado
403Usuário sem permissão para criar UI
409Conflito – UI já existente (mesma inscrição municipal)
500Erro interno da API

SINTER