--- title: "IBAMA Environmental Embargoes Search" method: POST path: "/br/ibama/embargoes-search/v1" tags: ["Brazil", "IBAMA (environmental embargoes)"] --- # IBAMA Environmental Embargoes Search `POST /br/ibama/embargoes-search/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/br/ibama/embargoes-search/v1` - Auth: HTTP bearer Search every environmental embargo Brazil's federal environmental agency (IBAMA) has imposed since 1987, by CPF or CNPJ (or its 8-character root), name or property, state, municipality, term number or date. Each embargo carries its status (`active`, `lifted`, `cancelled`), the area in hectares, the place, the infraction and the process; the response counts how many matches are active. CPFs are matched exactly and returned masked. Updated daily. **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## Headers - `Idempotency-Key` string ## Request body - object - `query` string: Palabras a buscar en los nombres (opcional). - `document_number` string: CPF o CNPJ de la persona o empresa embargada, con o sin puntuación, p. ej. `12.345.678/0001-90`, o la raíz de 8 caracteres de un CNPJ para todos sus establecimientos (opcional). Coincidencia exacta. - `status` '' | 'active' | 'lifted' | 'cancelled': Situación: `active` (embargo vigente), `lifted` (levantado) o `cancelled` (anulado) (opcional; por defecto todas). - `state` string: Sigla del estado (UF) del lugar embargado, p. ej. `PA` (opcional). - `municipality_code` string: Código IBGE de 7 dígitos del municipio del lugar embargado, p. ej. `1500602` (opcional). - `term_number` string: Número del término de embargo, tal como lo imprime IBAMA (opcional). Coincidencia exacta. - `from_date` string, date: Optional date filter in yyyy-mm-dd format. - `to_date` string, date: Optional date filter in yyyy-mm-dd format. - `page` integer: 1-based page number for paginated results. - `per_page` integer: Resultados por página (1-50). ## Response `200` Successful response - IbamaEmbargoesSearchResponse - `data` IbamaEmbargoesSearchData, required - `as_of` string, nullable, required: How current the data in this response is. - `query` string, required - `status` string, nullable, required - `state` string, nullable, required - `municipality_code` string, nullable, required - `from_date` string, nullable, required - `to_date` string, nullable, required - `total` number, required: Embargoes matching the filters, across every page, counted up to 1000. - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on. - `active` number, required: How many of them are `active`: a person or company's standing at a glance. Counted up to 1000, like `total`. - `page` number, required - `per_page` number, required - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false. - `count` number, required - `embargoes` object[], required - `id` string, required: IBAMA's sequence for the term, or `aie-` and the number of a term issued electronically and not yet in IBAMA's main system: the key. - `term_number` string, required: The term's number as IBAMA prints it (numbers repeat across series and reissues). - `term_series` string, nullable, required: The term's series letter, when it has one. - `status` 'active' | 'lifted' | 'cancelled', required: `active` (in force), `lifted` (lifted administratively or by a court) or `cancelled` (cancelled, replaced or deleted): IBAMA's own flags. - `record_status` string, nullable, required: The term's status in IBAMA's system, as IBAMA words it, e.g. `Lavrado`, `Cancelado`. - `embargo_date` string, nullable, required: `yyyy-mm-dd` the embargo was imposed. - `lift_type` 'administrative' | 'judicial' | 'pra', nullable, required: How it was lifted: `administrative`, `judicial`, or `pra` (an environmental recovery plan). - `lift_date` string, nullable, required: `yyyy-mm-dd` it was lifted. - `lift_reason` string, nullable, required: Why it was lifted, as IBAMA records it. - `name` string, nullable, required: The embargoed person or company, as IBAMA records it; a CPF inside a name is masked. - `party_type` 'individual' | 'company', nullable, required: `individual` (a CPF) or `company` (a CNPJ); null when IBAMA recorded no document. - `document_type` 'cpf' | 'cnpj', nullable, required - `document` string, nullable, required: A CNPJ in full (`12.345.678/0001-90`); a CPF masked (`***.456.789-**`). - `process_number` string, nullable, required: IBAMA's administrative process. - `infraction_notice_number` string, nullable, required: The infraction notice (auto de infração) the embargo came with. - `description` string, nullable, required: What was embargoed and why, as IBAMA records it. - `state` string, required: Two-letter state (UF) of the embargoed place. - `municipality_code` string, required: The IBGE code of the embargoed place's municipality. - `municipality` string, required - `location` string, nullable, required: How IBAMA describes where the place is. - `property_name` string, nullable, required: The rural property's name, when IBAMA records one. - `latitude` number, nullable, required - `longitude` number, nullable, required - `area_ha` number, nullable, required: The embargoed area in hectares, when IBAMA measured one. - `area_type` string, nullable, required: What the area is, as IBAMA words it, e.g. `Desmatamento`, `Queimada`, `Atividade`. - `last_changed_at` string, nullable, required: When IBAMA last changed the term, ISO 8601 in Brasília time. ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error --- [API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)