# Autorização Provisória de Funcionamento Rural

> Realiza consultas sobre Autorização Provisória de Funcionamento Rural (APF), verificando dados de propriedades agrícolas para conformidade ambiental e análise de risco.

- **Consulta:** `apf-rural`
- **Categoria:** Rural
- **Preço:** R$ 0,51 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/apf-rural`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/rural/apf-rural

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Permite consultar informações sobre Autorizações Provisórias de Funcionamento (APF) Rural. A APF é um ato administrativo declaratório que autoriza o exercício provisório de atividades de agricultura e pecuária extensiva ou semiextensiva em áreas rurais, dispensando a Licença Ambiental Única (LAU) durante seu período de validade.
>
> Este serviço é essencial para organizações que necessitam validar conformidade ambiental de operações rurais, avaliar riscos de propriedades agrícolas e implementar políticas ESG (Environmental, Social and Governance). Aplicável em cenários de:
>
> - **Análise de crédito e concessão de linhas de financiamento rural** — instituições financeiras podem verificar a regularidade ambiental de propriedades antes de aprovar operações.
> - **Conformidade e due diligence** — empresas que trabalham com cadeias de suprimento agrícola podem validar a documentação ambiental de fornecedores.
> - **Prevenção de riscos regulatórios** — identificar propriedades em situação irregular para evitar exposição a autuações fiscais.
> - **Reportes ESG** — incorporar dados oficiais de autorização ambiental em relatórios de sustentabilidade corporativa.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/apf-rural?cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/apf-rural",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/apf-rural");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

Informe `cpf` ou `cnpj`.

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | condicional | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |
| `cnpj` | CNPJ | condicional | CNPJ (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A consulta retorna detalhes sobre as autorizações ativas associadas ao documento informado:
>
> - **Identificação**: Nome do proprietário ou responsável, documento consultado, data da consulta.
> - **Imóvel**: Descrição e localização da propriedade, incluindo coordenadas geográficas, município e número de registro no Cadastro Ambiental Rural (CAR).
> - **APF**: Número da autorização, data de emissão e data de validade.
> - **Áreas**: Extensão total do imóvel e área sob utilização declarada na APF.
> - **Atividade**: Tipo de atividade agrícola ou pecuária autorizada.
> - **Situação**: Status da APF (ativa, expirada, etc.) e situação do CAR associado.
> - **Responsáveis**: Dados do proprietário e responsável técnico pelo registro.
> - **Informações complementares**: Observações adicionais e detalhes relevantes ao registro.
> - **Quantidade de autorizações**: Número total de APFs vinculadas ao documento.

### Exemplo de resposta

```json
{
  "observacoes": "Foi encontrado um resultado compatível com a pesquisa.",
  "autorizacoes": [
    {
      "apf": "12345/2021",
      "car": "MT12345/2019",
      "imovel": "FAZENDA EXEMPLO DO CERRADO",
      "status": "REGULAR",
      "atividade": "Agricultura e Pecuária",
      "municipio": "Sorriso",
      "dataEmissao": "10/05/2021",
      "responsavel": {
        "nome": "JOAO EXEMPLO DE OLIVEIRA",
        "documento": "111.111.111-11"
      },
      "situacaoCAR": "REGULAR",
      "dataValidade": "31/12/2027",
      "proprietario": {
        "nome": "AGROPECUARIA EXEMPLO LTDA",
        "documento": "11111111000111"
      },
      "informacoesAdicionais": {
        "areaTotal": "12.450,3200 ha",
        "coordenadas": "DATUM:SIRGAS 2000 - W: -55,11111111111001 - S: -12,3456789012345678",
        "areaUtilizada": "3.200,1000 ha"
      }
    }
  ],
  "documentoConsultado": "11.111.111/0001-11",
  "quantidadeAutorizacoes": 1
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "retorno": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "observacoes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Observações adicionais sobre o registro."
        },
        "autorizacoes": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "apf": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Número da autorização."
              },
              "car": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Número do CAR (Cadastro Ambiental Rural)."
              },
              "imovel": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Identificação do imóvel."
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Status atual da autorização."
              },
              "atividade": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Atividade autorizada no imóvel."
              },
              "municipio": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Município do imóvel."
              },
              "dataEmissao": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de emissão da autorização."
              },
              "responsavel": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "nome": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Nome do responsável."
                  },
                  "documento": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Documento do responsável (CPF ou CNPJ)."
                  }
                },
                "description": "Dados do responsável técnico."
              },
              "situacaoCAR": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Situação do registro no CAR."
              },
              "dataValidade": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data de validade da autorização."
              },
              "proprietario": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "nome": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Nome do proprietário."
                  },
                  "documento": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Documento do proprietário (CPF ou CNPJ)."
                  }
                },
                "description": "Dados do proprietário."
              },
              "informacoesAdicionais": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "areaTotal": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Área total do imóvel."
                  },
                  "coordenadas": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Coordenadas geográficas do imóvel."
                  },
                  "areaUtilizada": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Área utilizada do imóvel."
                  }
                },
                "description": "Informações adicionais sobre o imóvel."
              }
            }
          },
          "description": "Lista de autorizações encontradas."
        },
        "dataConsulta": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data da consulta realizada."
        },
        "documentoConsultado": {
          "type": [
            "string",
            "null"
          ],
          "description": "Documento consultado (CPF ou CNPJ)."
        },
        "quantidadeAutorizacoes": {
          "type": [
            "number",
            "null"
          ],
          "description": "Quantidade total de autorizações encontradas."
        }
      },
      "description": "Dados de retorno da consulta."
    },
    "metaDados": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "ip": {
          "type": [
            "string",
            "null"
          ],
          "description": "Endereço IP de origem da consulta."
        },
        "data": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data e hora de execução da consulta."
        },
        "chave": {
          "type": [
            "string",
            "null"
          ],
          "description": "Chave de acesso da consulta."
        },
        "usuario": {
          "type": [
            "string",
            "null"
          ],
          "description": "Usuário que realizou a consulta."
        },
        "mensagem": {
          "type": [
            "string",
            "null"
          ],
          "description": "Mensagem informativa sobre a consulta."
        },
        "apiVersao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Versão da API utilizada."
        },
        "resultado": {
          "type": [
            "string",
            "null"
          ],
          "description": "Status do resultado da consulta."
        },
        "assincrono": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se a consulta foi realizada de forma assíncrona."
        },
        "consultaUid": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identificador único da consulta."
        },
        "resultadoId": {
          "type": [
            "number",
            "null"
          ],
          "description": "Identificador do resultado."
        },
        "consultaNome": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nome da consulta realizada."
        },
        "enviarCallback": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se deve enviar callback."
        },
        "urlComprovante": {
          "type": [
            "string",
            "null"
          ],
          "description": "URL do comprovante gerado."
        },
        "tempoExecucaoMs": {
          "type": [
            "number",
            "null"
          ],
          "description": "Tempo de execução em milissegundos."
        },
        "gerarComprovante": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se deve gerar comprovante em PDF."
        }
      },
      "description": "Metadados da consulta."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Informe um único documento (CNPJ) por requisição.
> - O serviço realiza consulta a base de dados oficial de registros ambientais rurais.
> - A validade da APF está explicitada no campo de data de validade — verifique-a ao tomar decisões de crédito ou conformidade.
> - Propriedades sem APF ativa não retornarão registros; neste caso, a consulta pode resultar em resposta vazia ou erro 404.
> - Para suporte ou dúvidas sobre interpretação dos dados, contate o time de atendimento.

---

Página em HTML: https://fontedata.com/docs/rural/apf-rural
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp
