FiscalAPI
CNIR

Imóveis Rurais (CNIR/CAFIR)

Consulta o Cadastro Nacional de Imóveis Rurais (CNIR/CAFIR) da Receita Federal.

GET /api/consultar-cnir

Consulta o Cadastro Nacional de Imóveis Rurais (CNIR), também conhecido como CAFIR (Cadastro de Imóveis Rurais), mantido pela Receita Federal do Brasil. Retorna dados cadastrais do proprietário e a lista completa de imóveis rurais vinculados ao documento, incluindo informações de área, localização, situação e dados tributários.

O CNIR (Cadastro Nacional de Imóveis Rurais) é a base de dados oficial da Receita Federal que registra todos os imóveis rurais do Brasil. Cada imóvel é identificado pelo CIB (Cadastro Imobiliário Brasileiro) e pelo NIRF (Número do Imóvel na Receita Federal). Esses dados são essenciais para verificação de regularidade fundiária e tributária (ITR).

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes.

Parâmetros de consulta

Você deve informar exatamente um dos parâmetros cpf ou cnpj (não ambos).

NameTypeRequiredDescription
cpfstringNãoCPF do proprietário (somente números, 11 dígitos).
cnpjstringNãoCNPJ do proprietário (somente números, 14 dígitos).

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/consultar-cnir?cpf=12345678900" \
  -H "X-API-Key: fapi_sua_chave_aqui"
const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-cnir?cpf=12345678900",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
console.log(`Total de imoveis: ${data.total_imoveis}`);
data.imoveis_cafir.forEach((imovel) => {
  console.log(`${imovel.denominacao} - ${imovel.area_total} ha`);
});
import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-cnir",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cpf": "12345678900"},
)
data = response.json()
print(f"Total de imoveis: {data['total_imoveis']}")
for imovel in data["imoveis_cafir"]:
    print(f"{imovel['denominacao']} - {imovel['area_total']} ha")
$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar-cnir', [
    'cpf' => '12345678900',
]);
$data = $response->json();
var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/consultar-cnir?cpf=12345678900"
);
var data = await response.Content.ReadAsStringAsync();

Resposta

Campos de nível superior

CampoTipoDescrição
request_idstringIdentificador único da requisição (UUID).
documentstringDocumento enviado na consulta.
document_typestringTipo do documento: cpf ou cnpj.
source_statusobjectStatus da consulta (status, error_code, error_message).
pessoa_fisicaobject | nullDados cadastrais da pessoa física (quando CPF).
pessoa_juridicaobject | nullDados cadastrais da pessoa jurídica (quando CNPJ).
imoveis_cafirarrayLista de imóveis rurais cadastrados.
total_imoveisintegerTotal de imóveis encontrados.
total_imoveis_ativosintegerTotal de imóveis com situação ativa.

Campos de pessoa_fisica

CampoTipoDescrição
nomestringNome completo.
data_nascimentostringData de nascimento (formato YYYY-MM-DD).
situacao_cadastralstringSituação cadastral na Receita Federal.
sexostringSexo (M ou F).

Campos de cada imóvel (imoveis_cafir[])

CampoTipoDescrição
cibstringCadastro Imobiliário Brasileiro (identificador único do imóvel).
nirfstringNúmero do Imóvel na Receita Federal.
denominacaostringNome do imóvel (ex: FAZENDA SANTA MARIA).
area_totalnumberÁrea total em hectares.
situacaostringSituação do imóvel (ex: ATIVA, BAIXADA).
codigo_situacaointegerCódigo numérico da situação.
ni_proprietariostringDocumento do proprietário principal.
percentual_proprietarionumberPercentual de propriedade (0-100).
condominosarrayLista de condôminos (quando houver).
dados_tributariosobjectInformações tributárias do imóvel (ITR).
municipio_sedeobjectMunicípio sede do imóvel (codigo, uf, nome).

Campos de dados_tributarios

CampoTipoDescrição
indicador_descaracterizacaobooleanSe o imóvel foi descaracterizado como rural.
origem_imovelintegerCódigo de origem do imóvel.
data_aquisicaostringData de aquisição (formato YYYY-MM-DD).
area_adquiridanumberÁrea adquirida em hectares.
tipo_aquisicaostringTipo de aquisição (ex: COMPRA, HERANCA).
imunidadesarrayLista de imunidades tributárias aplicáveis.
possui_decisao_judicialbooleanSe existe decisão judicial sobre o imóvel.

Exemplo de resposta

{
  "request_id": "uuid",
  "document": "12345678900",
  "document_type": "cpf",
  "source_status": { "status": "success" },
  "pessoa_fisica": {
    "nome": "JOAO DA SILVA",
    "data_nascimento": "1980-05-15",
    "situacao_cadastral": "ATIVA",
    "sexo": "M"
  },
  "pessoa_juridica": null,
  "imoveis_cafir": [
    {
      "cib": "0.000.000-0",
      "nirf": "0000000",
      "denominacao": "FAZENDA SANTA MARIA",
      "area_total": 5000.5,
      "situacao": "ATIVA",
      "codigo_situacao": 1,
      "ni_proprietario": "12345678900",
      "percentual_proprietario": 100.0,
      "condominos": [],
      "dados_tributarios": {
        "indicador_descaracterizacao": false,
        "origem_imovel": 1,
        "data_aquisicao": "2015-06-01",
        "area_adquirida": 5000.5,
        "tipo_aquisicao": "COMPRA",
        "imunidades": [],
        "possui_decisao_judicial": false
      },
      "municipio_sede": {
        "codigo": "5103403",
        "uf": "MT",
        "nome": "RONDONOPOLIS"
      }
    }
  ],
  "total_imoveis": 1,
  "total_imoveis_ativos": 1
}

Códigos de erro

CódigoHTTP StatusDescrição
PARAMETRO_AUSENTE400Nenhum documento (cpf ou cnpj) foi informado.
PARAMETRO_CONFLITANTE400Ambos cpf e cnpj foram informados. Envie apenas um.
ERRO_INTERNO500Erro interno no servidor.

Esta pagina foi util?

On this page