Terra Intelligence · API

Consulte imóvel rural direto do seu sistema.

Mande o número do CAR, um CPF ou um CNPJ e receba em JSON o Compliance Socioambiental do imóvel: os sete critérios da CNSP 485, um por um. A API está em piloto.

Na conta grátis, você vê como o Compliance Socioambiental responde, em palavras, com as 10 análises grátis, pelo número do CAR. A resposta da API, em JSON, chega no piloto.

Com o que você pergunta

Pelo número do CAR, ou pelo CPF ou CNPJ do titular.

Por CAR

O número do imóvel no Cadastro Ambiental Rural. Volta os sete critérios da CNSP 485, o status do CAR e o detalhe de cada apontamento.

Por CPF ou CNPJ

Volta os imóveis rurais ligados ao titular, a confiança de cada vínculo com o CAR e, para cada imóvel, os mesmos sete critérios. O vínculo não prova propriedade.

Pelo número do CIB Em breve

CIB é o Cadastro Imobiliário Brasileiro. No imóvel rural, o código substituiu o NIRF da Receita. O CIB ainda não sai na conta nem na API. Em breve.

Pela API, hoje, saem o Compliance Socioambiental e a busca de imóveis por CPF ou CNPJ. O valor de referência e o pré-laudo saem pela tela da Terra Intelligence e em lote, com o nosso time.

Primeira consulta

Três passos até a primeira resposta.

  1. Peça a chave. A gente emite a chave para o CNPJ da sua empresa, dentro do piloto. Junto com ela vão o endereço da API e a referência completa dos campos.
  2. Mande a chave no cabeçalho. Toda chamada leva Authorization: Bearer seguido da sua chave.
  3. Mande o CAR. No corpo vai o campo cod_imovel. O cpf_cnpj do proponente é opcional, mas sem ele o critério de trabalho escravo volta pendente.

Se der errado

401
A chamada chegou sem chave, ou com um valor que não tem o formato da chave que a gente emite.
403
A chave tem o formato certo, mas não é reconhecida ou foi bloqueada.
422
Faltou um campo obrigatório, ou ele veio no formato errado. A resposta diz qual campo.
requisição
POST <endereço enviado com a chave>
Authorization: Bearer <sua chave>
Content-Type: application/json

{
  "cod_imovel": "MT-XXXXXXX-XXXXXXXXXXXXXXXX"
}

O endereço e a lista completa de rotas chegam junto com a chave. Sem o cpf_cnpj, como aqui, o critério de trabalho escravo volta pendente.

O que volta

Os sete critérios, cada um em S, N ou P.

No Compliance Socioambiental, cada critério da CNSP 485 volta com uma letra: S, N ou P. Junto vêm um status geral do imóvel, o detalhe do que foi apontado e, no campo disclaimer, a ressalva que vai em toda resposta.

Por critério

S
Satisfaz. Neste site: sem restrição naquele critério.
N
Não satisfaz. Neste site: com restrição naquele critério.
P
Pendente. Faltou dado para conferir, e a resposta diz qual.

Status geral do imóvel

SEM_RESTRICOES
Sem restrição: os sete critérios em S.
COM_RESTRICOES
Com restrição: basta um critério em N.
VERIFICACAO_ADICIONAL
Verificação adicional: nenhum critério em N e pelo menos um em P.
  • 1As seis vedações do Art. 3º e o embargo ambiental do Art. 4º, cada um em S, N ou P.
  • 2Um status geral do imóvel, pela regra da tabela acima.
  • 3No embargo, a fonte consultada e o detalhe da consulta.
  • 4Quando falta um dado de entrada, o critério volta P, com o motivo.
  • 5A lista nominal das fontes consultadas é enviada quando você pedir.

Cada campo, cada critério

car_ativo
CAR ativo
trabalho_escravo
Trabalho escravo
uc_publica
Unidade de conservação de domínio público
terra_indigena
Terra indígena
quilombola
Território quilombola
floresta_publica_b
Floresta pública não destinada
embargo_ambiental
Embargo ambiental federal (IBAMA)
resposta · recorte anonimizado
{
  "cod_imovel": "MT-XXXXXXX-XXXXXXXXXXXXXXXX",
  "status": "VERIFICACAO_ADICIONAL",
  "validacoes_cnsp_485": {
    "car_ativo": "S",
    "trabalho_escravo": "P",
    "uc_publica": "S",
    "terra_indigena": "S",
    "quilombola": "S",
    "floresta_publica_b": "S",
    "embargo_ambiental": "P"
  },
  "car_status_legivel": "Ativo, aguardando análise",
  "embargo_detalhe": {
    "tem_embargo": false,
    "fonte": [
      "IBAMA federal"
    ],
    "consulta_estadual_realizada": false,
    "ufs_estaduais_consultadas": [],
    "observacao": "Embargos estaduais não consultados. Requer validação manual."
  },
  "floresta_publica_b_detalhe": {
    "tem_sobreposicao": false,
    "fonte": "CNFP/SFB, atualização 2024 retificada em 18/07/2025"
  },
  "disclaimer": "Esta análise resulta da agregação automatizada de consultas a fontes oficiais [...] A decisão de contratação, dispensa ou recusa do seguro rural é integral e exclusiva da sociedade seguradora [...]"
}

Recorte de uma resposta de seguro rural, com o código do imóvel mascarado e a ressalva encurtada. A resposta completa tem outros campos, descritos na referência que vai junto com a chave.

Carteira por planilha

Suba a carteira e acompanhe pelo número do lote.

Mande um arquivo .csv com a coluna car, a coluna cpf_cnpj ou as duas. A API recebe o arquivo e devolve na hora um número de acompanhamento. Por ele você consulta o andamento: pendente, processando, concluído ou erro. Quando o lote termina, os resultados vêm nessa mesma consulta, no formato da resposta por CAR.

O limite de linhas por arquivo vai junto com a chave.

lote por planilha
# carteira.csv
car,cpf_cnpj
MT-XXXXXXX-XXXXXXXXXXXXXXXX,
GO-XXXXXXX-XXXXXXXXXXXXXXXX,00000000000

# envio: o arquivo no campo file (multipart)
202  volta o número do lote, em job_id

# acompanhamento: consulta com o job_id
status      pendente, processando, concluido ou erro
resultados  no formato da resposta por CAR, quando concluir
Como a chave funciona

Uma chave por CNPJ, com volume combinado.

Emissão

A chave é emitida para o CNPJ da sua empresa, dentro do piloto. Não existe cadastro automático.

A chave fica só com você

Do nosso lado fica só um código de conferência da chave, nunca a chave em si. Se você perder a sua, a gente bloqueia a antiga e emite outra.

Volume combinado

O volume do mês é combinado antes, no piloto. Não publicamos um teto único.

Bloqueio

Chave bloqueada para de funcionar em até um minuto, sem esperar versão nova da API.

Em breve · fale com a gente

A consulta do imóvel, como ferramenta do seu agente de IA.

O MCP é o protocolo que deixa um agente de IA chamar ferramentas de fora. Quando abrir, um assistente compatível com MCP vai poder consultar um imóvel com a sua chave. Ainda não tem data.

Quero testar quando abrir →
Antes de integrar

O que existe hoje, e o que ainda não.

Como eu autentico?
Chave no cabeçalho Authorization: Bearer. Uma chave por CNPJ, emitida no piloto. Tem
Tem exemplo de requisição e de resposta?
Tem, nesta página. A referência completa dos campos vai junto com a chave. Tem
Qual é o limite de chamadas?
O volume do mês é combinado no piloto.
Quanto custa testar?
Pela tela, a conta grátis vem com 10 análises grátis, para usar pelo número do CAR. Pela API, o escopo e as condições do piloto são combinados antes de começar.
Tem SDK?
Não. É REST com JSON, e qualquer cliente HTTP serve.
Tem ambiente de testes?
Não público. No piloto, a gente roda com você uma amostra dos seus imóveis.
Tem página de status?
Não. Quando existir, o link entra aqui.
Como fico sabendo de mudança?
Não há registro público de mudanças. No piloto, mudança de contrato é avisada por e-mail antes de valer.
Tem MCP?
Ainda não, e ainda não tem data. Em breve

Peça acesso ao piloto.

Conte o caso de uso e o volume por mês. A gente responde com o desenho da integração e o prazo.

Pedir acesso ao piloto →

Prefere e-mail? contact@abundancebrasil.com

Nós informamos. A instituição decide.