> ## 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
> Busca todos los avisos que la autoridad minera de Colombia ha publicado desde 2020 por placa, punto de atención, tipo o fecha, y lee el texto completo de cualquiera.
La Agencia Nacional de Minería (ANM) administra los títulos y las solicitudes mineras de Colombia. Cuando no puede notificar una decisión personalmente, publica un aviso: un estado, un aviso, un edicto o una publicación de carácter general, cada uno con las placas (números de título o de solicitud) a las que se refiere.
Son cerca de 19.000 desde mayo de 2020, de la sede central en Bogotá y once puntos de atención regional. Búscalos por placa, punto de atención, tipo o fecha de publicación, o con texto libre que llega al cuerpo de cada aviso, y luego lee uno completo.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar los avisos
`POST /co/anm/notices-search/v1` Dataset
Una búsqueda sobre todos los avisos desde mayo de 2020, por placa, punto de atención, tipo o fecha, o con texto libre sobre el texto completo.
| Campo | Tipo | Notas |
| -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palabras opcionales que se buscan en el número del aviso y en su texto completo. |
| `title_number` | string | Placa opcional (número de título o de solicitud minera), p. ej. `ABC-12345`. Coincidencia exacta; se ignoran mayúsculas y espacios. |
| `office` | enum | Punto de atención regional opcional: `bogota`, `bucaramanga`, `ibague`, `pasto`, `cali`, `cartagena`, `cucuta`, `manizales`, `medellin`, `nobsa`, `quibdo` o `valledupar`. |
| `type` | enum | Tipo de aviso opcional: `estado`, `aviso`, `edicto` o `caracter_general`. |
| `year` | integer | Año de publicación opcional. 0 busca en todos los años. Por defecto `0`. |
| `from_date` | string | Opcional: solo avisos publicados en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo avisos publicados en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `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" }'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`, `total_pages`, `count` y `results[]`, de la publicación más reciente a la más antigua. Cada resultado incluye `id` (el identificador permanente del aviso, p. ej. `GGDN-2026-P-0378.pdf`), `notice_number` (p. ej. `GGDN-2026-EST-165`), `type` (`estado`, `aviso`, `edicto` o `caracter_general`), `office` (el punto de atención regional, p. ej. `Bogotá`), `publication_date`, `year`, `title_numbers` (todas las placas que cubre el aviso), `text_status` (`extracted`, `no_text_layer` o `unavailable`) y `document_url` (el documento del aviso tal como lo publica la ANM).
Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra el aviso; para leer el texto usa el endpoint ANM Notice.
## Un aviso, completo
`POST /co/anm/notice/v1` Dataset
| Campo | Tipo | Notas |
| ----------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `notice_id` | string | **Obligatorio.** El `id` del aviso que devuelve la búsqueda, p. ej. `GGDN-2026-P-0378.pdf`, o su `document_url`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de los avisos caben en una sola respuesta. Por defecto `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" }'
```
Devuelve `as_of`, `found`, `notice_id` y `notice`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo del aviso, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el identificador permanente del aviso, p. ej. `GGDN-2026-P-0378.pdf`), `notice_number` (p. ej. `GGDN-2026-EST-165`), `type` (`estado`, `aviso`, `edicto` o `caracter_general`), `office` (el punto de atención regional, p. ej. `Bogotá`), `publication_date`, `year`, `title_numbers` (todas las placas que cubre el aviso), `text_status` (`extracted`, `no_text_layer` o `unavailable`) y `document_url` (el documento del aviso tal como lo publica la ANM).
`content` es null cuando `text_status` es `no_text_layer` (la ANM publicó el aviso como imagen) o `unavailable`; `document_url` sigue enlazando el documento.
Un `id` que la ANM no ha publicado devuelve `found: false` con HTTP 200, no un error.
Esquemas, todos los campos de respuesta y un playground interactivo.