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

# Superintendencia de Seguridad Social

> Los dictámenes de la SUSESO de Chile: busca en unos 16.100 pronunciamientos de seguridad social desde 1971, y lee cualquiera completo con sus temas, dictámenes relacionados y archivos.

La Superintendencia de Seguridad Social (SUSESO) fiscaliza la seguridad social de Chile: las licencias médicas y las COMPIN, los accidentes del trabajo y las enfermedades profesionales de la Ley 16.744 y las mutualidades, la asignación familiar, las cajas de compensación (CCAF) y su crédito social, los servicios de bienestar, entre otros. Sus dictámenes fijan cómo se aplican esas normas, muchos en respuesta a un trabajador, un empleador o una institución. Hay unos 16.100 publicados, desde 1971 hasta hoy. Cada uno llega aquí con su número y fecha, a quién va dirigido, el resumen de la SUSESO, sus temas y descriptores, las fuentes legales en que se funda, las unidades que lo emitieron, los dictámenes, circulares y normas que la SUSESO relaciona con él, los archivos que adjunta, su texto completo y una copia exacta de su página en la SUSESO.

Busca por número, año, fecha, tema o un dictamen relacionado, o con texto libre que llega hasta el resumen 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/suseso/dictamenes-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Una sola búsqueda sobre todos los dictámenes que publica la SUSESO desde 1971, filtrada por número, año, fecha, tema o un dictamen relacionado.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el número, el destinatario, el resumen, los temas, los descriptores, las fuentes legales y el texto completo, p. ej. `licencia médica rechazo` o `crédito social`. Todas las palabras deben aparecer. |
| `number` | string | Número de dictamen opcional, como lo publica la SUSESO, con su año, p. ej. `150250-2026` u `O-01-S-04558-2026`. |
| `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`. |
| `topic` | string | Tema opcional, exactamente como aparece en `topics` de un resultado, p. ej. `Licencias médicas` o `Seguro laboral (Ley 16.744)`. |
| `related_to` | string | `id` de dictamen opcional, p. ej. `758965`: solo los dictámenes que la SUSESO lista como relacionados con é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/suseso/dictamenes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "licencia médica", "topic": "Licencias médicas" }'
```

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 en la SUSESO, p. ej. `758965`), `number` (como lo publica la SUSESO, p. ej. `O-01-S-00582-2025` o `4268-1988`), `title`, `year`, `issued_date`, `recipient` (a quién va dirigido), `summary` (el resumen de la SUSESO, que no tienen la mayoría de los dictámenes anteriores a 2019), `topics`, `descriptors`, `legal_sources`, `departments` (las unidades de la SUSESO que lo emitieron), `action`, `criterion` y `validity` (cuando la SUSESO los indica), `related_circulars_text` y `related_oficios_text` (las circulares y oficios con los que concuerda, tal como están escritos), `other_fields` (cualquier otro campo con etiqueta), `related_dictamenes` y `related_circulars` (cada uno con su `id`, `title` e `issued_date`), `related_legislation`, `attachments` (cada archivo con su `title`, `name`, `content_type`, `bytes`, `document_url` y `source_document_url`), `official_url` (la página del dictamen en la SUSESO), `document_url` (la copia exacta de esa página que guarda Croma), `source_document_url` y `document_versions`. Los campos que la SUSESO 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 SUSESO Dictamen.

> [!NOTE]
>
> La SUSESO agrega dictámenes y circulares relacionados a un dictamen a medida que aparecen otros nuevos. Croma lee los dictámenes nuevos cada día y vuelve a leer todos una vez al mes.

## Un dictamen, completo

`POST /cl/suseso/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. `758965`, su `official_url`, o su número, p. ej. `O-01-S-00582-2025`. |
| `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/suseso/dictamen/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "dictamen_id": "758965" }'
```

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`. Cada resultado incluye `id` (el id permanente del dictamen en la SUSESO, p. ej. `758965`), `number` (como lo publica la SUSESO, p. ej. `O-01-S-00582-2025` o `4268-1988`), `title`, `year`, `issued_date`, `recipient` (a quién va dirigido), `summary` (el resumen de la SUSESO, que no tienen la mayoría de los dictámenes anteriores a 2019), `topics`, `descriptors`, `legal_sources`, `departments` (las unidades de la SUSESO que lo emitieron), `action`, `criterion` y `validity` (cuando la SUSESO los indica), `related_circulars_text` y `related_oficios_text` (las circulares y oficios con los que concuerda, tal como están escritos), `other_fields` (cualquier otro campo con etiqueta), `related_dictamenes` y `related_circulars` (cada uno con su `id`, `title` e `issued_date`), `related_legislation`, `attachments` (cada archivo con su `title`, `name`, `content_type`, `bytes`, `document_url` y `source_document_url`), `official_url` (la página del dictamen en la SUSESO), `document_url` (la copia exacta de esa página que guarda Croma), `source_document_url` y `document_versions`. Los campos que la SUSESO 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 SUSESO 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.