> ## 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.
# ANM
> Pesquise todos os avisos que a autoridade de mineração da Colômbia publicou desde 2020 por placa, escritório, tipo ou data, e leia o texto completo de qualquer um.
A Agencia Nacional de Minería (ANM) administra os títulos e os pedidos de mineração da Colômbia. Quando não consegue notificar uma decisão pessoalmente, publica um aviso: um estado, um aviso, um edital ou uma publicação de caráter geral, cada um com as placas (números de título ou de pedido) a que se refere.
São cerca de 19.000 desde maio de 2020, da sede em Bogotá e de onze escritórios regionais. Pesquise-os por placa, escritório, tipo ou data de publicação, ou com texto livre que alcança o corpo de cada aviso, e depois leia um completo.
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).
## Pesquisar os avisos
`POST /co/anm/notices-search/v1` Dataset
Uma busca sobre todos os avisos desde maio de 2020, por placa, escritório, tipo ou data, ou com texto livre sobre o texto completo.
| Campo | Tipo | Notas |
| -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palavras opcionais buscadas no número do aviso e no texto completo. |
| `title_number` | string | Placa opcional (número de título ou de pedido de mineração), p. ex. `ABC-12345`. Correspondência exata; maiúsculas e espaços são ignorados. |
| `office` | enum | Escritório regional opcional: `bogota`, `bucaramanga`, `ibague`, `pasto`, `cali`, `cartagena`, `cucuta`, `manizales`, `medellin`, `nobsa`, `quibdo` ou `valledupar`. |
| `type` | enum | Tipo de aviso opcional: `estado`, `aviso`, `edicto` ou `caracter_general`. |
| `year` | integer | Ano de publicação opcional. 0 busca em todos os anos. Por padrão `0`. |
| `from_date` | string | Opcional: só avisos publicados nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só avisos publicados nesta data ou antes, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `20`. |
```bash theme={"dark"}
curl https://api.croma.run/co/anm/notices-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "office": "bogota", "type": "estado" }'
```
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `results[]`, da publicação mais recente à mais antiga. Cada resultado traz `id` (o identificador permanente do aviso, p. ex. `GGDN-2026-P-0378.pdf`), `notice_number` (p. ex. `GGDN-2026-EST-165`), `type` (`estado`, `aviso`, `edicto` ou `caracter_general`), `office` (o escritório regional, p. ex. `Bogotá`), `publication_date`, `year`, `title_numbers` (todas as placas que o aviso cobre), `text_status` (`extracted`, `no_text_layer` ou `unavailable`) e `document_url` (o documento do aviso como a ANM o publica).
Os resultados da busca não incluem o texto. `query` busca dentro dele, então uma frase do corpo encontra o aviso; para ler o texto use o endpoint ANM Notice.
## Um aviso, completo
`POST /co/anm/notice/v1` Dataset
| Campo | Tipo | Notas |
| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| `notice_id` | string | **Obrigatório.** O `id` do aviso retornado pela busca, p. ex. `GGDN-2026-P-0378.pdf`, ou sua `document_url`. |
| `offset` | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. |
| `limit` | integer | Quantos caracteres do texto retornar. A maioria dos avisos cabe em uma resposta. Por padrão `200000`. |
```bash theme={"dark"}
curl https://api.croma.run/co/anm/notice/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "notice_id": "GGDN-2026-P-0378.pdf" }'
```
Retorna `as_of`, `found`, `notice_id` e `notice`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo do aviso, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o identificador permanente do aviso, p. ex. `GGDN-2026-P-0378.pdf`), `notice_number` (p. ex. `GGDN-2026-EST-165`), `type` (`estado`, `aviso`, `edicto` ou `caracter_general`), `office` (o escritório regional, p. ex. `Bogotá`), `publication_date`, `year`, `title_numbers` (todas as placas que o aviso cobre), `text_status` (`extracted`, `no_text_layer` ou `unavailable`) e `document_url` (o documento do aviso como a ANM o publica).
`content` é null quando `text_status` é `no_text_layer` (a ANM publicou o aviso como imagem) ou `unavailable`; `document_url` continua apontando para o documento.
Um `id` que a ANM não publicou retorna `found: false` com HTTP 200, não um erro.
Esquemas, todos os campos de resposta e um playground interativo.