> ## 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.

# Contraloría General de la República

> Los dictámenes de la Contraloría de Chile: busca en unos 158.000 pronunciamientos de derecho administrativo desde 1949, y lee cualquiera completo con su estado y los dictámenes sobre los que actúa.

La Contraloría General de la República de Chile emite dictámenes, pronunciamientos obligatorios sobre cómo los órganos públicos deben aplicar el derecho administrativo: remuneraciones, feriados y pensiones de los funcionarios, compras públicas, atribuciones municipales, obras públicas. Su jurisprudencia está publicada desde 1949, unos 158.000 dictámenes. Cada uno llega aquí con su número, año y fecha, la materia que resuelve, los descriptores de la Contraloría y las fuentes legales en que se funda, si genera o aplica jurisprudencia, sus estados (reconsiderado, aplicado, aclarado y los demás, que cambian cuando un dictamen posterior actúa sobre él), los dictámenes anteriores sobre los que actúa, a quién va dirigido, la unidad de la que proviene, su texto completo y enlaces a su página y a su PDF en la Contraloría.

Busca por número, año, fecha, criterio, estado o el dictamen sobre el que actúa uno posterior, o con texto libre que llega hasta la materia y el cuerpo de cada dictamen. Busca primero y luego lee un dictamen completo.

> [!NOTE]
>
> 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](https://docs.usecroma.com/es/datasets.md).

## Buscar dictámenes

`POST /cl/contraloria-cl/dictamenes-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Una sola búsqueda sobre todos los dictámenes que publica la Contraloría desde 1949, filtrada por número, año, fecha, criterio, estado o el dictamen sobre el que actúa uno posterior.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el número, la materia, los descriptores, las fuentes legales y el texto completo, p. ej. `pensión de retiro` o `feriado legal`. Todas las palabras deben aparecer. |
| `number` | string | Número de dictamen opcional, con su prefijo de letras si lo tiene, p. ej. `428`, `E152884`. Los ceros a la izquierda no importan. Agrega `year` para identificar un solo dictamen. |
| `year` | integer | Año del dictamen opcional. 0 busca en todos los años. Por defecto `0`. |
| `from_date` | string | Opcional: solo dictámenes emitidos en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo dictámenes emitidos en esta fecha o antes, `yyyy-mm-dd`. |
| `criterion` | enum | Opcional: `generates` (genera jurisprudencia) o `applies` (aplica jurisprudencia). |
| `status` | enum | Estado opcional: `new`, `applied`, `reconsidered` (reconsiderado), `partially_reconsidered`, `clarified` (aclarado), `altered`, `confirmed`, `complemented` o `reactivated`. |
| `references` | string | `id` de dictamen opcional, p. ej. `022127N09`: solo los dictámenes que actúan sobre él. |
| `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/cl/contraloria-cl/dictamenes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "pensión de retiro", "criterion": "generates" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, del dictamen más reciente al más antiguo. Cada resultado incluye `id` (el id permanente del dictamen, p. ej. `E152884N21`), `number` (como lo cita la Contraloría, p. ej. `E152884`) y `year`, `issued_date`, `subject` (la materia), `descriptors`, `legal_sources`, `criterion` (`generates` si genera jurisprudencia o `applies` si la aplica), `statuses` y `status_flags` (`new`, `applied`, `reconsidered`, `partially_reconsidered`, `clarified`, `altered`, `confirmed`, `complemented`, `reactivated`), `related` (los dictámenes anteriores sobre los que actúa, cada uno con su `action`, `dictamen_id`, `number` y `year`) y `action_text` (la frase de la propia Contraloría sobre ellos), `recipients`, `attorneys`, `origin` y `origins` (la unidad de la Contraloría), `character`, `protection_appeal`, `topic`, `relevant`, `bulletin`, `official_url` (la página del dictamen en la Contraloría), `source_document_url` (su PDF en la Contraloría) y `document_url` (siempre null: la Contraloría publica el dictamen como texto, y el texto está aquí). Los campos que la Contraloría no indica vienen en null.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto. `query` sí busca dentro de él, así que una frase del cuerpo encuentra el dictamen; para leer el texto usa el endpoint Contraloría Chile Dictamen.

> [!NOTE]
>
> Los estados cambian cuando un dictamen posterior aplica, reconsidera o aclara uno anterior. Croma vuelve a leer los dictámenes sobre los que actúa cada dictamen nuevo el día en que aparece, y toda la colección una vez al mes.

## Un dictamen, completo

`POST /cl/contraloria-cl/dictamen/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

| Campo | Tipo | Notas |
| - | - | - |
| `dictamen_id` | string | **Obligatorio.** El `id` del dictamen que devuelve la búsqueda, p. ej. `E152884N21`, su `official_url`, o su número y año, p. ej. `E152884/2021`. |
| `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. Casi todos los dictámenes caben en una sola respuesta. Por defecto `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/contraloria-cl/dictamen/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "dictamen_id": "E152884N21" }'
```

Devuelve `as_of`, `found`, `dictamen_id` y `dictamen`, que trae todo lo que devuelve la búsqueda más `content` (una ventana sobre el texto completo, con `text`, `offset`, `total_length`, `has_more` y `next_offset`) y `referenced_by` (los dictámenes posteriores que actúan sobre este, cada uno con su `id`, `number`, `year`, `issued_date` y `actions`, del más reciente al más antiguo). Cada resultado incluye `id` (el id permanente del dictamen, p. ej. `E152884N21`), `number` (como lo cita la Contraloría, p. ej. `E152884`) y `year`, `issued_date`, `subject` (la materia), `descriptors`, `legal_sources`, `criterion` (`generates` si genera jurisprudencia o `applies` si la aplica), `statuses` y `status_flags` (`new`, `applied`, `reconsidered`, `partially_reconsidered`, `clarified`, `altered`, `confirmed`, `complemented`, `reactivated`), `related` (los dictámenes anteriores sobre los que actúa, cada uno con su `action`, `dictamen_id`, `number` y `year`) y `action_text` (la frase de la propia Contraloría sobre ellos), `recipients`, `attorneys`, `origin` y `origins` (la unidad de la Contraloría), `character`, `protection_appeal`, `topic`, `relevant`, `bulletin`, `official_url` (la página del dictamen en la Contraloría), `source_document_url` (su PDF en la Contraloría) y `document_url` (siempre null: la Contraloría publica el dictamen como texto, y el texto está aquí). Los campos que la Contraloría no indica vienen en null.

> [!NOTE]
>
> Los dictámenes largos se leen por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.

> [!NOTE]
>
> Un id que la Contraloría no ha publicado devuelve `found: false` con HTTP 200, no un error.

> **[Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)**
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.