> ## 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 statistics: survey indicators, social security contributors, the minimum wage, child labour risk and official reports.

Figures from Guatemala's Ministerio de Trabajo y Previsión Social, by
year, department and municipality. Names and categories stay in Spanish, as the
Ministry publishes them.

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

One row per survey round, breakdown and category. Newest round first. Within
a round the breakdowns sort alphabetically, so `total` (the national figure)
comes last: send `breakdown` to get one series.

| 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 }'
```

## 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). The codes are listed at the end of this page. |
| `activity` | enum | Optional: `agricultural`, `export_and_maquila`, `non_agricultural` (the rest of the private sector) or `public`. |
| `from_date` | string | Optional. First month, as `yyyy-mm-dd`. Any day counts as its whole month. |
| `to_date` | string | Optional. Last month, as `yyyy-mm-dd`. Any day counts as its whole month. |
| `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"
      }'
```

## 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 }'
```

## 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). The codes are listed at the end of this page. |
| `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" }'
```

## 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" }'
```

## Response

Every endpoint returns the same envelope and echoes your filters under their own names.

| Field | Notes |
| - | - |
| `as_of` | How current the data is. |
| `total`, `total_is_exact` | Matches, counted up to 1,000. `total_is_exact` is `false` when there are more. |
| `page`, `per_page`, `total_pages`, `count` | Paging. `count` is the rows on this page. When `total_is_exact` is `false`, `total_pages` stops at the cap, so keep requesting pages until `results[]` is empty. |
| `results[]` | The rows, described below. |

### Labour indicator fields

Counts are weighted persons and rates are percentages. Figures are `null` where the survey does not report them: `unemployed` is always `null` on `economic_activity` and `occupational_category` rows, which describe the employed.

| Field | Notes |
| - | - |
| `series_id` | Row id, e.g. `ENEIC:2026-T1:sex:Mujer`. |
| `survey`, `year` | The survey and the year of the round. |
| `period`, `period_start` | The round as published (`2019-2`, `2023`, `2026-T1`) and the date that orders it. |
| `breakdown`, `category` | The dimension and the category within it, e.g. `sex` and `Mujer`. `category` is `null` on `total` rows. |
| `population` | Everyone in the category. |
| `working_age_population`, `working_age_share` | People aged 15 or more, and their share of the population. |
| `labour_force`, `participation_rate` | Employed plus unemployed, and their share of the working-age population. |
| `employed`, `employment_rate` | People in work, and their share of the labour force. |
| `unemployed`, `unemployment_rate` | People without work and looking, and their share of the labour force. |
| `informal_employed`, `informality_rate` | Employed in the informal sector, and their share of the employed. |
| `underemployed`, `underemployment_rate` | Working fewer hours than they want, and their share of the labour force. |
| `average_income` | Average monthly labour income of the employed, in quetzales. |

> [!NOTE]
>
> Rounds are not strictly comparable across surveys: the ENEI, the ENCOVI and the ENEIC differ in design and fieldwork. Activity and ethnic group labels follow each survey's coding.

### IGSS contributor fields

| Field | Notes |
| - | - |
| `contributor_id` | Row id, e.g. `2026-09:01:agricultural`. |
| `period`, `period_start`, `year` | The month as `yyyy-mm`, its first day and its year. |
| `department_code`, `department` | The department's code and name. |
| `activity`, `activity_name` | The activity and its published label, e.g. `Agrícola`. |
| `sector` | `private` or `public`. |
| `circumscription` | The department's minimum wage circumscription, `CE1` or `CE2`. |
| `contributors` | Contributing members that month. |

### Minimum wage fields

| Field | Notes |
| - | - |
| `wage_id` | Row id, e.g. `nominal:2026:agricultural:CE1`. |
| `measure` | `nominal` or `real`. |
| `period`, `period_start` | `yyyy` on nominal rows, `yyyy-mm` on real rows, and the period's first day. |
| `year`, `month` | `month` is `null` on nominal rows. |
| `activity`, `activity_name` | The activity and its published label, e.g. `Agrícola`. |
| `circumscription` | `CE1` (the department of Guatemala) or `CE2` (the other 21 departments). |
| `amount` | Quetzales per month. |

### Child labour risk fields

| Field | Notes |
| - | - |
| `municipality_code`, `municipality` | The INE's four-digit code and the name, e.g. `1601` and `Cobán`. |
| `department_code`, `department` | The department's code and name. |
| `region_code`, `region` | The planning region's code and name, e.g. `6` and `VI - Suroccidente`. |
| `children` | Children the estimate covers. |
| `children_in_child_labour` | Children estimated to be in child labour. |
| `prevalence` | Estimated share of children in child labour, percent. |
| `prevalence_lower`, `prevalence_upper` | The estimate's confidence interval, percent. |
| `standard_error` | Standard error of the estimate, percentage points. |
| `coefficient_of_variation` | Standard error over the estimate. |
| `estimate_quality` | The Ministry's grade for the estimate, e.g. `Excelente`. |
| `national_risk_level`, `national_risk` | Risk against the country, 1 to 5, and its label, e.g. `Muy Alto`. |
| `regional_risk_level`, `regional_risk` | Risk against the municipality's own region, 1 to 5, and its label. |

### Publication fields

| Field | Notes |
| - | - |
| `publication_id`, `file_name` | The file's name as published. |
| `title`, `description` | Its title and short description. `description` is often `null`. |
| `headings[]`, `section` | The headings the Ministry files it under, outermost first, and the innermost one. |
| `format`, `bytes` | File type and size in bytes. |
| `modified_at` | When the Ministry last changed the file. |
| `document_url` | Croma's byte-identical copy, `null` while the copy is pending. |
| `source_document_url` | The file on the Ministry's site. |
| `document_versions[]` | Every version Croma keeps, oldest first, each with `document_url`, `modified_at` and `bytes`. Gains an entry when the Ministry replaces the file. |

## Department and region codes

| Region (`region_code`) | Departments (`department_code`) |
| - | - |
| `1` Metropolitana | `01` Guatemala |
| `2` Norte | `15` Baja Verapaz, `16` Alta Verapaz |
| `3` Nororiente | `02` El Progreso, `18` Izabal, `19` Zacapa, `20` Chiquimula |
| `4` Suroriente | `06` Santa Rosa, `21` Jalapa, `22` Jutiapa |
| `5` Central | `03` Sacatepéquez, `04` Chimaltenango, `05` Escuintla |
| `6` Suroccidente | `07` Sololá, `08` Totonicapán, `09` Quetzaltenango, `10` Suchitepéquez, `11` Retalhuleu, `12` San Marcos |
| `7` Noroccidente | `13` Huehuetenango, `14` Quiché |
| `8` Petén | `17` Petén |

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