Documentação API SICAR - Umbrella Store

Visão geral

A API SICAR fornece acesso direto aos dados de imóveis rurais por código CAR ou por CPF/CNPJ. As respostas são em JSON e foram projetadas para integrações backend, aplicações web e fluxos internos de análise.

Autenticação

Solicite a liberação da API com a Umbrella Technology.
Receba seu token exclusivo no dashboard do cliente.
Envie o token no header Authorization em cada chamada.

Authorization: Bearer umb_token_exemplo_xxxxxxxxx

Créditos e cobrança

Esta API segue o modelo pré-pago (pay as you go). A cobrança ocorre apenas em respostas HTTP 200, de acordo com o preço de cada endpoint. Você pode acompanhar consumo, saldo restante e histórico no dashboard da API.

Endpoints

GET /v1/car/{codigoCar} R$ 0,50 Retorna dados básicos do CAR (sem lista de proprietários)

Parâmetros

Nome	Obrigatório	Tipo	Descrição
`codigoCar`	Sim	string	Código CAR no formato UF-CodigoMunicipio-Hash.

Exemplo de resposta

{
  "success": true,
  "cache": true,
  "dados": {
    "codigoCar": "UF-1234567-ABCD.EF12.3456.7890.ABCD.EF12.3456.7890",
    "nomeImovel": "FAZENDA MODELO A",
    "areaTotalHa": "150,0000",
    "dataCadastro": "01/02/2024 00:00:00",
    "matriculaNumero": "12345",
    "matriculaData": "20/01/2024",
    "matriculaCartorio": "Cartório Modelo/UF",
    "tipoImovel": "Imóvel Rural",
    "municipio": "Cidade Exemplo",
    "uf": "ESTADO EXEMPLO",
    "codigoProtocolo": "UF-1234567-PROT.0001.0002.0003.0004.0005.0006.0007",
    "latitude": "10°00'00,00 S",
    "longitude": "40°00'00,00 O",
    "modulosFiscais": "5,0000"
  },
  "dataConsulta": "2026-03-26T19:42:17.7444013Z",
  "dataExpiracao": null
}

GET /v1/proprietario/{cpfCnpj} R$ 1,50 Retorna os CARs vinculados ao CPF/CNPJ informado

Parâmetros

Nome	Obrigatório	Tipo	Descrição
`cpfCnpj`	Sim	string	CPF ou CNPJ (somente dígitos ou formatado).

Exemplo de resposta

{
  "success": true,
  "total": 2,
  "itens": [
    {
      "registroCar": "UF-1234567-ABCD.EF12.3456.7890.ABCD.EF12.3456.7890",
      "codigoProtocolo": "UF-1234567-PROT.1111.2222.3333.4444.5555.6666.7777",
      "nomeImovel": "SÍTIO DEMONSTRAÇÃO 01",
      "matriculaNumero": "10101",
      "municipio": "Cidade Exemplo",
      "uf": "Estado Exemplo",
      "areaTotalHa": "45,9000",
      "proprietarioConsultado": "PESSOA FICTÍCIA A"
    },
    {
      "registroCar": "UF-7654321-9999.8888.7777.6666.5555.4444.3333.2222",
      "codigoProtocolo": null,
      "nomeImovel": "FAZENDA DEMONSTRAÇÃO 02",
      "matriculaNumero": "20202",
      "municipio": "Município Modelo",
      "uf": "Estado Modelo",
      "areaTotalHa": "87,3000",
      "proprietarioConsultado": "PESSOA FICTÍCIA B"
    }
  ]
}

Códigos HTTP e erros

Status	Erro	Descrição	Correção sugerida
`200`	-	Requisição processada com sucesso (gera cobrança).	Nenhuma ação necessária.
`400`	`CODIGO_CAR_INVALIDO`	Código CAR em formato inválido.	Enviar no padrão UF-CodigoMunicipio-Hash.
`400`	`CPF_CNPJ_INVALIDO`	CPF/CNPJ com formato inválido.	Enviar documento válido.
`401`	`TOKEN_INVALIDO`	Token ausente ou inválido.	Enviar header `Authorization: Bearer ...` válido.
`402`	`SALDO_INSUFICIENTE`	Saldo insuficiente para executar a consulta.	Adicionar créditos no dashboard.
`404`	`CAR_NAO_ENCONTRADO`	Código CAR não encontrado na base.	Validar o código e tentar novamente.
`404`	`CPF_CNPJ_NAO_ENCONTRADO`	Documento sem CARs vinculados na base.	Conferir documento consultado.
`429`	`LIMITE_EXCEDIDO`	Rate limit ou limites de consumo excedidos.	Aguardar ou ajustar limites no dashboard.
`500`	`ERRO_INTERNO`	Erro interno do servidor.	Tentar novamente e acionar suporte se persistir.

Exemplos de código

JavaScript (fetch)

const response = await fetch(
  "https://api.umbrellatecnologia.com/v1/proprietario/12345678901",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer umb_token_exemplo_xxxxxxxxx"
    }
  }
);

const data = await response.json();
console.log(data);

Python (requests)

import requests

url = "https://api.umbrellatecnologia.com/v1/car/BA-2918407-6B9BF14D1B5C4A68B3556361634660D0"
headers = {
    "Authorization": "Bearer umb_token_exemplo_xxxxxxxxx"
}

response = requests.get(url, headers=headers, timeout=30)
print(response.status_code)
print(response.json())