> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IBAMA (embargos)

> Todo embargo ambiental que o IBAMA aplicou desde 1987, por CPF, CNPJ, nome, imóvel ou local: a área embargada em hectares, a infração e se está vigente, desembargado ou cancelado, atualizado diariamente.

O IBAMA embarga áreas e atividades onde encontra desmatamento ilegal,
queimadas ou outras infrações ambientais, e publica cada embargo com o seu
titular. As normas do crédito rural vedam financiamento em área embargada,
então bancos e financiadores do agronegócio verificam tomadores e imóveis
contra essa lista.

Pesquise por CPF ou CNPJ (ou a raiz de um CNPJ, para todas as filiais), por
nome ou imóvel, por estado ou município, e receba cada embargo com área,
local, infração e situação. A pesquisa também informa quantos estão
vigentes.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Pesquisar embargos

`POST /br/ibama/embargoes-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Encontra embargos por documento, nome, local, situação ou data.

| Campo               | Tipo    | Notas                                                                                                                                 |
| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `query`             | string  | Opcional. Palavras do nome do embargado ou do imóvel, p. ex. `fazenda`. Todas precisam coincidir.                                     |
| `document_number`   | string  | Opcional. Um CPF ou CNPJ, com ou sem pontuação, correspondência exata; ou os 8 primeiros caracteres de um CNPJ para todas as filiais. |
| `status`            | enum    | Opcional. `active`, `lifted` ou `cancelled`; todas por padrão.                                                                        |
| `state`             | string  | Opcional. Sigla do estado do local embargado, p. ex. `PA`.                                                                            |
| `municipality_code` | string  | Opcional. Código IBGE de 7 dígitos do município, p. ex. `1500602`.                                                                    |
| `term_number`       | string  | Opcional. O número do termo de embargo, exato.                                                                                        |
| `from_date`         | string  | Opcional. Embargos aplicados a partir desta data, `yyyy-mm-dd`.                                                                       |
| `to_date`           | string  | Opcional. Embargos aplicados até esta data, `yyyy-mm-dd`.                                                                             |
| `page`              | integer | Opcional. Página, a partir de 1. Por padrão `1`.                                                                                      |
| `per_page`          | integer | Opcional. Resultados por página, 1-50. Por padrão `20`.                                                                               |

```bash theme={"dark"}
curl https://api.croma.run/br/ibama/embargoes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "state": "PA", "status": "active", "per_page": 5 }'
```

Cada embargo é `{ id, term_number, term_series, status, record_status, embargo_date, lift_type, lift_date, lift_reason, name, party_type, document_type, document, process_number, infraction_notice_number, description, state, municipality_code, municipality, location, property_name, latitude, longitude, area_ha, area_type, last_changed_at }`.

* `status`: `active` (vigente), `lifted` (desembargado, com `lift_type` `administrative`, `judicial` ou `pra`, e `lift_date`) ou `cancelled` (cancelado). É a marcação do próprio IBAMA.
* `document`: um CNPJ completo; um CPF mascarado (`***.456.789-**`). Um CPF escrito dentro de um nome ou de uma descrição também é mascarado.
* `area_ha`: a área embargada em hectares, quando o IBAMA a mediu; `latitude` e `longitude` quando o IBAMA registrou um ponto no Brasil.

A pesquisa também retorna `active`: quantos dos embargos encontrados estão vigentes, então uma única chamada por CPF ou CNPJ responde se uma pessoa ou empresa tem embargo vigente.

<Note>
  Os dados incluem embargos desembargados e cancelados além dos vigentes,
  desde 1987. Filtre com `status: "active"` para o que está vigente hoje.
</Note>

## Um embargo

`POST /br/ibama/embargo/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Retorna um embargo pelo id.

| Campo | Tipo   | Notas                                                                           |
| ----- | ------ | ------------------------------------------------------------------------------- |
| `id`  | string | **Obrigatório.** **Obrigatório.** O `id` do embargo, como a pesquisa o retorna. |

```bash theme={"dark"}
curl https://api.croma.run/br/ibama/embargo/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "id": "1234567" }'
```

Cada embargo é `{ id, term_number, term_series, status, record_status, embargo_date, lift_type, lift_date, lift_reason, name, party_type, document_type, document, process_number, infraction_notice_number, description, state, municipality_code, municipality, location, property_name, latitude, longitude, area_ha, area_type, last_changed_at }`.

* `status`: `active` (vigente), `lifted` (desembargado, com `lift_type` `administrative`, `judicial` ou `pra`, e `lift_date`) ou `cancelled` (cancelado). É a marcação do próprio IBAMA.
* `document`: um CNPJ completo; um CPF mascarado (`***.456.789-**`). Um CPF escrito dentro de um nome ou de uma descrição também é mascarado.
* `area_ha`: a área embargada em hectares, quando o IBAMA a mediu; `latitude` e `longitude` quando o IBAMA registrou um ponto no Brasil.

A pesquisa também retorna `active`: quantos dos embargos encontrados estão vigentes, então uma única chamada por CPF ou CNPJ responde se uma pessoa ou empresa tem embargo vigente.

<Note>
  Os dados incluem embargos desembargados e cancelados além dos vigentes,
  desde 1987. Filtre com `status: "active"` para o que está vigente hoje.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>