> ## 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 (embargoes)
> Every environmental embargo IBAMA has imposed since 1987, by CPF, CNPJ, name, property or place: the embargoed area in hectares, the infraction, and whether it is active, lifted or cancelled, updated daily.
IBAMA, Brazil's federal environmental agency, embargoes land and
activities where it finds illegal deforestation, burning or other
environmental infractions, and publishes every embargo with its holder. The
rural-credit rules forbid lending on an embargoed area, so banks and
agribusiness lenders screen borrowers and properties against it.
Search by CPF or CNPJ (or a CNPJ's root, for every branch), by name or
property, by state or municipality, and get each embargo with its area, place,
infraction and status. The search also says how many of the matches are
active.
The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
## Search embargoes
`POST /br/ibama/embargoes-search/v1` Dataset
Finds embargoes by document, name, place, status or date.
| Field | Type | Notes |
| ------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional. Words in the embargoed party's name or the property's name, e.g. `fazenda`. Every word must match. |
| `document_number` | string | Optional. A CPF or CNPJ, with or without punctuation, matched exactly; or a CNPJ's first 8 characters to match every branch. |
| `status` | enum | Optional. `active`, `lifted` or `cancelled`; any by default. |
| `state` | string | Optional. Two-letter state of the embargoed place, e.g. `PA`. |
| `municipality_code` | string | Optional. The municipality's 7-digit IBGE code, e.g. `1500602`. |
| `term_number` | string | Optional. The embargo term's number, exact. |
| `from_date` | string | Optional. Embargoes imposed on or after this date, `yyyy-mm-dd`. |
| `to_date` | string | Optional. Embargoes imposed on or before this date, `yyyy-mm-dd`. |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-50. Default `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 }'
```
Each embargo is `{ 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` (in force), `lifted` (with `lift_type` `administrative`, `judicial` or `pra`, and `lift_date`) or `cancelled`. This is IBAMA's own flag.
* `document`: a CNPJ in full; a CPF masked (`***.456.789-**`). A CPF written inside a name or a description is masked too.
* `area_ha`: the embargoed area in hectares, when IBAMA measured one; `latitude` and `longitude` when IBAMA recorded a point in Brazil.
The search also returns `active`: how many of the matching embargoes are in force, so a single call by CPF or CNPJ answers whether a person or company has an active embargo.
The data keeps lifted and cancelled embargoes as well as active ones, back
to 1987. Filter with `status: "active"` for what is in force today.
## One embargo
`POST /br/ibama/embargo/v1` Dataset
Returns one embargo by its id.
| Field | Type | Notes |
| ----- | ------ | ------------------------------------------------------------------------- |
| `id` | string | **Required.** **Required.** The embargo's `id`, as the search returns it. |
```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" }'
```
Each embargo is `{ 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` (in force), `lifted` (with `lift_type` `administrative`, `judicial` or `pra`, and `lift_date`) or `cancelled`. This is IBAMA's own flag.
* `document`: a CNPJ in full; a CPF masked (`***.456.789-**`). A CPF written inside a name or a description is masked too.
* `area_ha`: the embargoed area in hectares, when IBAMA measured one; `latitude` and `longitude` when IBAMA recorded a point in Brazil.
The search also returns `active`: how many of the matching embargoes are in force, so a single call by CPF or CNPJ answers whether a person or company has an active embargo.
The data keeps lifted and cancelled embargoes as well as active ones, back
to 1987. Filter with `status: "active"` for what is in force today.
Schemas, all response fields, and an interactive playground.