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

> Guatemala's labour market from the Ministerio de Trabajo y Previsión Social: survey indicators since 2012, IGSS contributors by department and month, the minimum wage since 1995, child labour risk by municipality and every report the Ministry publishes.

The labour market statistics of Guatemala's Ministerio de Trabajo y Previsión
Social (Dirección de Estadística Laboral): the indicators of the INE household
surveys (ENEI, ENCOVI and the quarterly ENEIC) for the country and by sex, area,
age, ethnic group, activity and occupational category; the contributing members
of the IGSS by department, activity and month since 2017; the nominal and real
minimum wage since 1995 for both economic circumscriptions; the child labour risk
model (MIRTI) for all 340 municipalities; and every report, bulletin and data
file the Ministry publishes, kept by Croma.

Every series is organized and ready to query: the unemployment rate of women in
each survey round, the formal employment of a department month by month, or the
minimum wage a maquila paid in 2019, each in one fast call.

> [!NOTE]
>
> The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](https://docs.usecroma.com/datasets.md).

## Labour market indicators

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

The survey indicators, filtered by survey, breakdown and years. Newest round
first; within a round, `total` then each breakdown's categories.

| Field | Type | Notes |
| - | - | - |
| `survey` | enum | Optional: `ENEI` (2012-2022), `ENEIC` (quarterly since 2024-T4) or `ENCOVI` (2023). |
| `breakdown` | enum | Optional: `total`, `sex`, `area` (metropolitan, other urban, rural), `age_group`, `ethnicity`, `economic_activity` or `occupational_category`. Activity and category rows describe the employed. |
| `year_from` | integer | Optional first year, inclusive. `0` sets no bound. Default `0`. |
| `year_to` | integer | Optional last year, inclusive. `0` sets no bound. Default `0`. |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-500. Default `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 }'
```

Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`.

## IGSS contributors

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

Contributing members by department, activity and month. Newest month first.

| Field | Type | Notes |
| - | - | - |
| `department_code` | string | Optional two-digit department code, `01` (Guatemala) to `22` (Jutiapa), in the order the INE numbers them. |
| `activity` | enum | Optional: `agricultural`, `export_and_maquila`, `non_agricultural` (the rest of the private sector) or `public`. |
| `from_date` | string | Optional. First month (`yyyy-mm-dd`, the month it falls in counts). |
| `to_date` | string | Optional. Last month (`yyyy-mm-dd`, inclusive). |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-500. Default `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"
      }'
```

Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`.

## Minimum wage

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

The minimum wage in quetzales per month, nominal by year and real by month.
Newest first.

| Field | Type | Notes |
| - | - | - |
| `measure` | enum | Optional: `nominal` (one row per year and activity, the wage in force) or `real` (one row per month, deflated by the consumer price index). Both when empty. |
| `activity` | enum | Optional: `agricultural`, `non_agricultural` or `export_and_maquila` (published since 2008). |
| `circumscription` | enum | Optional: `CE1` (the department of Guatemala) or `CE2` (the other 21 departments). The two only differ in 2014 and since 2023. |
| `year_from` | integer | Optional first year, inclusive. `0` sets no bound. Default `0`. |
| `year_to` | integer | Optional last year, inclusive. `0` sets no bound. Default `0`. |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-500. Default `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 }'
```

Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`.

## Child labour risk

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

The municipalities of a department or region, those at a risk level, or
those whose name matches. Highest estimated prevalence first.

| Field | Type | Notes |
| - | - | - |
| `department_code` | string | Optional two-digit department code, `01` (Guatemala) to `22` (Jutiapa), in the order the INE numbers them. |
| `region_code` | integer | Optional planning region, 1 (Metropolitana) to 8 (Petén). `0` sets no filter. Default `0`. |
| `risk_level` | integer | Optional national risk level, 1 (very low) to 5 (very high). `0` sets no filter. Default `0`. |
| `query` | string | Optional words of the municipality's or department's name, accents optional, e.g. `coban`. |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-500. Default `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" }'
```

Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`.

## Reports and data files

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

The documents the Ministry publishes, by words in their title or section.
Most recently changed first.

| Field | Type | Notes |
| - | - | - |
| `query` | string | Optional words to match in the title, description or section, e.g. `empleador 2025`. |
| `format` | enum | Optional: `pdf` (reports and bulletins) or `zip` (data files and scripts). |
| `page` | integer | Optional. 1-based page. Default `1`. |
| `per_page` | integer | Optional. Results per page, 1-500. Default `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" }'
```

Returns `as_of` (how current the data is), the applied filters, `total` and `total_is_exact`, `page`, `per_page`, `total_pages`, `count` and `results[]`.

## Response

Every response carries `as_of`: how current the data is.

### Labour indicators (`results[]`)

| Field | Notes |
| - | - |
| `series_id` | The row's identity: survey, round, breakdown and category. |
| `survey`, `year`, `period`, `period_start` | The survey round: `ENEI` 2012-2022 (one to three rounds a year, "2019-2"), `ENCOVI` 2023, `ENEIC` quarterly since 2024 ("2026-T1"). `period_start` orders the rounds. |
| `breakdown`, `category` | `total`, or the dimension and the category within it, as the survey labels it. |
| `population`, `working_age_population`, `labour_force`, `employed`, `unemployed`, `informal_employed`, `underemployed` | Weighted persons. |
| `working_age_share`, `participation_rate`, `employment_rate`, `unemployment_rate`, `informality_rate`, `underemployment_rate` | Percent, two decimals. |
| `average_income` | Average monthly labour income of the employed, quetzales. |

### IGSS contributors (`results[]`)

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

### Minimum wage (`results[]`)

`wage_id`, `measure` (`nominal` by year, `real` by month), `period`, `period_start`,
`year`, `month`, `activity`, `activity_name`, `circumscription` (`CE1` the department
of Guatemala, `CE2` the rest) and `amount` in quetzales per month.

### Child labour risk (`results[]`)

`municipality_code` (the INE's four digits), `municipality`, `department_code`,
`department`, `region_code`, `region`, `children`, `children_in_child_labour`,
`prevalence` with `prevalence_lower` and `prevalence_upper` (percent),
`standard_error`, `coefficient_of_variation`, `estimate_quality`,
`national_risk_level` and `national_risk` (1 to 5 against the country),
`regional_risk_level` and `regional_risk` (against the municipality's region).

### Publications (`results[]`)

`publication_id`, `title`, `description`, `headings[]` and `section` (where the
page lists the file), `file_name`, `format`, `bytes`, `modified_at`,
`source_document_url` (the Ministry's link), `document_url` (Croma's byte-identical
copy, always available) and `document_versions[]` when the Ministry replaced the
file at the same link.

> [!NOTE]
>
> The labour indicators are the Ministry's own figures from the INE household
> surveys. Rounds are not strictly comparable across surveys: the ENEI, the
> ENCOVI and the ENEIC differ in design and fieldwork, and the category labels
> of economic activities and ethnic groups follow each survey's codebook.

> [card] [Full reference](https://docs.usecroma.com/api-reference/overview.md)
>
> Schemas, all response fields, and an interactive playground.


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