Rural e ambiental
Consulta Códigos de Imóveis Rurais por CPF
O serviço de Consulta Códigos de Imóveis Rurais por CPF retorna os códigos de imóveis registrados no CCIR vinculados ao CPF informado, com base em dados oficiais do SNCR.
Quando usar
Descrição
O serviço de Consulta Códigos de Imóveis Rurais por CPF realiza a busca na base do Sistema Nacional de Cadastro Rural (SNCR) para listar todos os imóveis rurais associados ao CPF informado.
Requisição
Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.
POST /api/v1/{tenant}/pessoas/consulta-codigos-de-imoveis-rurais-por-cpf
| Campo | Obrigatório | Descrição |
|---|---|---|
document |
sim | CPF da pessoa, com ou sem máscara. |
{
"document": "000.000.000-00"
}
Campos de retorno
Campos dentro de data. [] indica lista.
| Campo | Tipo |
|---|---|
quantidade_imoveis |
número |
codigos_imovel[] |
texto |
Exemplo de resposta
Estrutura real da resposta, com valores fictícios.
{
"execution_id": "00000000-0000-0000-0000-000000000000",
"status": "success",
"message": "Consulta realizada com sucesso",
"query_name": "Consulta Códigos de Imóveis Rurais por CPF",
"query_slug": "consulta-codigos-de-imoveis-rurais-por-cpf",
"data": {
"quantidade_imoveis": 0,
"codigos_imovel": [
"texto"
]
},
"consulted_at": "2026-01-01T12:00:00Z",
"query_cost": "3.000"
}
Cobrança e respostas
- O valor é cobrado por consulta bem-sucedida.
- 200 — consulta processada (veja status no corpo da resposta)
- 401 — token ausente, inválido, inativo ou expirado
- 403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
- 422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
- 429 — limite de requisições por minuto da chave excedido
- 504 — tempo máximo de execução do serviço excedido