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

# Mintrabajo

> El mercado laboral de Guatemala según el Ministerio de Trabajo y Previsión Social: indicadores de las encuestas desde 2012, afiliados al IGSS por departamento y mes, el salario mínimo desde 1995, el riesgo de trabajo infantil por municipio y cada informe que publica el Ministerio.

Las estadísticas del mercado de trabajo del Ministerio de Trabajo y Previsión
Social de Guatemala (Dirección de Estadística Laboral): los indicadores de las
encuestas de hogares del INE (ENEI, ENCOVI y la ENEIC trimestral) para el país y
por sexo, dominio, edad, pueblo, actividad y categoría ocupacional; los afiliados
cotizantes al IGSS por departamento, actividad y mes desde 2017; el salario mínimo
nominal y real desde 1995 para las dos circunscripciones económicas; el modelo de
riesgo de trabajo infantil (MIRTI) de los 340 municipios; y cada informe, boletín
y archivo de datos que publica el Ministerio, conservado por Croma.

Cada serie está organizada y lista para consultar: la tasa de desempleo de las
mujeres en cada ronda, el empleo formal de un departamento mes a mes o el salario
mínimo que pagaba una maquila en 2019, cada una en una sola llamada rápida.

> [!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).

## Indicadores del mercado laboral

`POST /gt/mintrabajo-gt/labour-indicators/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Los indicadores de las encuestas, filtrados por encuesta, desagregación y
años. La ronda más reciente primero; dentro de una ronda, `total` y luego las
categorías de cada desagregación.

| Campo | Tipo | Notas |
| - | - | - |
| `survey` | enum | Opcional: `ENEI` (2012-2022), `ENEIC` (trimestral desde 2024-T4) o `ENCOVI` (2023). |
| `breakdown` | enum | Opcional: `total`, `sex`, `area` (metropolitano, resto urbano, rural), `age_group`, `ethnicity`, `economic_activity` o `occupational_category`. Las filas de actividad y categoría describen a los ocupados. |
| `year_from` | integer | Primer año opcional, inclusive. `0` no pone límite. Por defecto `0`. |
| `year_to` | integer | Último año opcional, inclusive. `0` no pone límite. Por defecto `0`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/gt/mintrabajo-gt/labour-indicators/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "breakdown": "sex", "year_from": 2024 }'
```

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[]`.

## Afiliados al IGSS

`POST /gt/mintrabajo-gt/igss-contributors/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Afiliados cotizantes por departamento, actividad y mes. El mes más reciente
primero.

| Campo | Tipo | Notas |
| - | - | - |
| `department_code` | string | Código opcional del departamento, dos dígitos, `01` (Guatemala) a `22` (Jutiapa), en el orden en que los numera el INE. |
| `activity` | enum | Opcional: `agricultural`, `export_and_maquila`, `non_agricultural` (el resto del sector privado) o `public`. |
| `from_date` | string | Opcional. Primer mes (`yyyy-mm-dd`, cuenta el mes en que cae). |
| `to_date` | string | Opcional. Último mes (`yyyy-mm-dd`, inclusive). |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/gt/mintrabajo-gt/igss-contributors/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "department_code": "01",
        "activity": "non_agricultural",
        "from_date": "2026-01-01"
      }'
```

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[]`.

## Salario mínimo

`POST /gt/mintrabajo-gt/minimum-wage/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

El salario mínimo en quetzales al mes, nominal por año y real por mes. El más
reciente primero.

| Campo | Tipo | Notas |
| - | - | - |
| `measure` | enum | Opcional: `nominal` (una fila por año y actividad, el salario vigente) o `real` (una fila por mes, deflactado por el índice de precios al consumidor). Ambos si se omite. |
| `activity` | enum | Opcional: `agricultural`, `non_agricultural` o `export_and_maquila` (publicado desde 2008). |
| `circumscription` | enum | Opcional: `CE1` (el departamento de Guatemala) o `CE2` (los otros 21 departamentos). Solo difieren en 2014 y desde 2023. |
| `year_from` | integer | Primer año opcional, inclusive. `0` no pone límite. Por defecto `0`. |
| `year_to` | integer | Último año opcional, inclusive. `0` no pone límite. Por defecto `0`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/gt/mintrabajo-gt/minimum-wage/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "measure": "nominal", "year_from": 2020 }'
```

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[]`.

## Riesgo de trabajo infantil

`POST /gt/mintrabajo-gt/child-labour-risk/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Los municipios de un departamento o región, los de un nivel de riesgo, o
aquellos cuyo nombre coincide. La mayor prevalencia estimada primero.

| Campo | Tipo | Notas |
| - | - | - |
| `department_code` | string | Código opcional del departamento, dos dígitos, `01` (Guatemala) a `22` (Jutiapa), en el orden en que los numera el INE. |
| `region_code` | integer | Región opcional, 1 (Metropolitana) a 8 (Petén). `0` no filtra. Por defecto `0`. |
| `risk_level` | integer | Nivel de riesgo nacional opcional, 1 (muy bajo) a 5 (muy alto). `0` no filtra. Por defecto `0`. |
| `query` | string | Palabras opcionales del nombre del municipio o del departamento, con o sin tildes, p. ej. `coban`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/gt/mintrabajo-gt/child-labour-risk/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "department_code": "16" }'
```

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[]`.

## Informes y archivos de datos

`POST /gt/mintrabajo-gt/publications-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Los documentos que publica el Ministerio, por palabras de su título o
sección. El modificado más recientemente primero.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales a buscar en el título, la descripción o la sección, p. ej. `empleador 2025`. |
| `format` | enum | Opcional: `pdf` (informes y boletines) o `zip` (archivos de datos y sintaxis). |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Por defecto `100`. |

```bash theme={"dark"}
curl https://api.croma.run/gt/mintrabajo-gt/publications-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "trabajo infantil" }'
```

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[]`.

## Respuesta

Cada respuesta incluye `as_of`: qué tan actualizados están los datos.

### Indicadores laborales (`results[]`)

| Campo | Notas |
| - | - |
| `series_id` | La identidad de la fila: encuesta, ronda, desagregación y categoría. |
| `survey`, `year`, `period`, `period_start` | La ronda de la encuesta: `ENEI` 2012-2022 (de una a tres rondas al año, "2019-2"), `ENCOVI` 2023, `ENEIC` trimestral desde 2024 ("2026-T1"). `period_start` ordena las rondas. |
| `breakdown`, `category` | `total`, o la dimensión y la categoría dentro de ella, como la nombra la encuesta. |
| `population`, `working_age_population`, `labour_force`, `employed`, `unemployed`, `informal_employed`, `underemployed` | Personas ponderadas. |
| `working_age_share`, `participation_rate`, `employment_rate`, `unemployment_rate`, `informality_rate`, `underemployment_rate` | Porcentaje, dos decimales. |
| `average_income` | Ingreso laboral mensual promedio de los ocupados, en quetzales. |

### Afiliados al IGSS (`results[]`)

`contributor_id`, `period` (`yyyy-mm`), `period_start`, `year`, `department_code`,
`department`, `activity` (`agricultural`, `export_and_maquila`, `non_agricultural`,
`public`), `activity_name`, `sector`, `circumscription` y `contributors`.

### Salario mínimo (`results[]`)

`wage_id`, `measure` (`nominal` por año, `real` por mes), `period`, `period_start`,
`year`, `month`, `activity`, `activity_name`, `circumscription` (`CE1` el departamento
de Guatemala, `CE2` el resto) y `amount` en quetzales al mes.

### Riesgo de trabajo infantil (`results[]`)

`municipality_code` (los cuatro dígitos del INE), `municipality`, `department_code`,
`department`, `region_code`, `region`, `children`, `children_in_child_labour`,
`prevalence` con `prevalence_lower` y `prevalence_upper` (porcentaje),
`standard_error`, `coefficient_of_variation`, `estimate_quality`,
`national_risk_level` y `national_risk` (1 a 5 frente al país),
`regional_risk_level` y `regional_risk` (frente a la región del municipio).

### Publicaciones (`results[]`)

`publication_id`, `title`, `description`, `headings[]` y `section` (dónde lista la
página el archivo), `file_name`, `format`, `bytes`, `modified_at`,
`source_document_url` (el enlace del Ministerio), `document_url` (la copia idéntica
byte a byte de Croma, siempre disponible) y `document_versions[]` cuando el
Ministerio reemplazó el archivo en el mismo enlace.

> [!NOTE]
>
> Los indicadores laborales son las cifras del propio Ministerio a partir de las
> encuestas de hogares del INE. Las rondas no son estrictamente comparables entre
> encuestas: la ENEI, la ENCOVI y la ENEIC difieren en diseño y trabajo de campo,
> y las etiquetas de actividad económica y de pueblo siguen el codebook de cada
> encuesta.

> [card] [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.