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

# Dirección del Trabajo

> La doctrina laboral de la Dirección del Trabajo de Chile: busca en unos 13.000 dictámenes, ordinarios, circulares, órdenes de servicio y resoluciones por tipo, número, fecha o texto, y lee cualquiera completo con su archivo original.

La Dirección del Trabajo (DT) es la autoridad laboral de Chile: fiscaliza los lugares de trabajo e interpreta la legislación laboral para empleadores, trabajadores y sindicatos. Esa interpretación se publica como doctrina administrativa, y es lo que hay aquí:

* **Dictámenes**: unos 5.000 desde 1990, los pronunciamientos que fijan la doctrina de la DT, numerados `<número>/<correlativo>` (p. ej. `388/32`).
* **Ordinarios**: unos 7.900, las respuestas de la DT a consultas concretas, que aplican su doctrina.
* **Circulares, órdenes de servicio y resoluciones**: las instrucciones y resoluciones de la DT que inciden en cómo se aplica la ley laboral.

Cada uno llega con su número y fecha, sus materias y su resumen, las partes rotuladas de su texto (actuación, antecedentes, fuentes, concordancias, quién firma y a quién se dirige), el índice propio de la DT de pronunciamientos concordantes y de normas citadas, el texto completo y cada archivo que la DT publicó con él, guardado byte a byte. Busca primero y luego lee uno 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 pronunciamientos

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

Una sola búsqueda sobre todos los dictámenes, ordinarios, circulares, órdenes de servicio y resoluciones que publica la Dirección del Trabajo, filtrada por tipo, número, año o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales en español, que se buscan en el título, las materias, el resumen, los descriptores y el texto completo, p. ej. `registro de asistencia`. Todas las palabras deben aparecer. |
| `type` | enum | Tipo opcional: `dictamen` (fija doctrina), `ordinario` (responde una consulta), `circular`, `orden_de_servicio` o `resolucion`. |
| `number` | string | Número opcional: `388/32` para un dictamen con su correlativo, o `388` para todos los pronunciamientos con ese número. No importan los puntos, los espacios ni los ceros a la izquierda. |
| `year` | integer | Año de emisión opcional. 0 busca en todos los años. Por defecto `0`. |
| `from_date` | string | Opcional: solo los emitidos en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo los emitidos 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/cl/dt-cl/pronouncements-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "registro de asistencia", "type": "dictamen" }'
```

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 más reciente al más antiguo. Cada resultado trae `id` (el id permanente de la DT, p. ej. `129643`), `type` (`dictamen`, `ordinario`, `circular`, `orden_de_servicio` o `resolucion`), `title` (p. ej. ORD.N°388/32), `number` (normalizado, p. ej. `388/32`) y `correlative` (la parte de un dictamen después de `/`), `issued_at` y `year`, `subjects` (las materias), `summary` (el resumen), `keywords` (los descriptores de la DT), las partes rotuladas del texto: `action` (ACTUACIÓN), `background` (ANTECEDENTES), `legal_sources` (FUENTES), `concordances` (CONCORDANCIA), `sender` (DE) y `recipient` (A), y cada parte en orden en `sections` (cada una con `label` y `text`), `concordance_tags` y `legal_references` (el índice propio de la DT de pronunciamientos concordantes y de normas citadas), `related` (los pronunciamientos que la DT lista como concordantes, cada uno con `id`, `type`, `title` e `issued_at`), `documents` (cada archivo que la DT publica con él, cada uno con `name`, `label`, `format`, `size_kb`, `document_url`, la copia idéntica byte a byte de Croma, y `source_document_url`), `document_url` y `source_document_url` (los del primer archivo) y `text_source`. Los campos que la DT no indica vienen en null o vacíos.

> [!NOTE]
>
> Los resultados de búsqueda no incluyen el texto completo. `query` sí busca dentro de él; para leer el texto usa el endpoint Dirección del Trabajo Chile Pronouncement.

## Un pronunciamiento, completo

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

| Campo | Tipo | Notas |
| - | - | - |
| `pronouncement_id` | string | **Obligatorio.** El `id` del pronunciamiento que devuelve la búsqueda, p. ej. `129643`. |
| `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 pronunciamientos caben en una sola respuesta. Por defecto `200000`. |

```bash theme={"dark"}
curl https://api.croma.run/cl/dt-cl/pronouncement/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "pronouncement_id": "129643" }'
```

Devuelve `as_of`, `found`, `pronouncement_id` y `pronouncement`, 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 trae `id` (el id permanente de la DT, p. ej. `129643`), `type` (`dictamen`, `ordinario`, `circular`, `orden_de_servicio` o `resolucion`), `title` (p. ej. ORD.N°388/32), `number` (normalizado, p. ej. `388/32`) y `correlative` (la parte de un dictamen después de `/`), `issued_at` y `year`, `subjects` (las materias), `summary` (el resumen), `keywords` (los descriptores de la DT), las partes rotuladas del texto: `action` (ACTUACIÓN), `background` (ANTECEDENTES), `legal_sources` (FUENTES), `concordances` (CONCORDANCIA), `sender` (DE) y `recipient` (A), y cada parte en orden en `sections` (cada una con `label` y `text`), `concordance_tags` y `legal_references` (el índice propio de la DT de pronunciamientos concordantes y de normas citadas), `related` (los pronunciamientos que la DT lista como concordantes, cada uno con `id`, `type`, `title` e `issued_at`), `documents` (cada archivo que la DT publica con él, cada uno con `name`, `label`, `format`, `size_kb`, `document_url`, la copia idéntica byte a byte de Croma, y `source_document_url`), `document_url` y `source_document_url` (los del primer archivo) y `text_source`. Los campos que la DT no indica vienen en null o vacíos.

> [!NOTE]
>
> Los textos 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 Dirección del Trabajo 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.