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

> O mercado de trabalho da Guatemala segundo o Ministerio de Trabajo y Previsión Social: indicadores das pesquisas desde 2012, contribuintes do IGSS por departamento e mês, o salário mínimo desde 1995, o risco de trabalho infantil por município e cada relatório que o Ministério publica.

As estatísticas do mercado de trabalho do Ministerio de Trabajo y Previsión Social
da Guatemala (Dirección de Estadística Laboral): os indicadores das pesquisas
domiciliares do INE (ENEI, ENCOVI e a ENEIC trimestral) para o país e por sexo,
área, idade, grupo étnico, atividade e categoria ocupacional; os contribuintes do
IGSS por departamento, atividade e mês desde 2017; o salário mínimo nominal e real
desde 1995 para as duas circunscrições econômicas; o modelo de risco de trabalho
infantil (MIRTI) dos 340 municípios; e cada relatório, boletim e arquivo de dados
que o Ministério publica, guardado pela Croma.

Cada série está organizada e pronta para consultar: a taxa de desemprego das
mulheres em cada rodada, o emprego formal de um departamento mês a mês ou o
salário mínimo que uma maquila pagava em 2019, cada uma em uma única chamada rápida.

> [!NOTE]
>
> A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](https://docs.usecroma.com/pt/datasets.md).

## Indicadores do mercado de trabalho

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

Os indicadores das pesquisas, filtrados por pesquisa, desagregação e anos. A
rodada mais recente primeiro; dentro de uma rodada, `total` e depois as
categorias de cada desagregação.

| Campo | Tipo | Notas |
| - | - | - |
| `survey` | enum | Opcional: `ENEI` (2012-2022), `ENEIC` (trimestral desde 2024-T4) ou `ENCOVI` (2023). |
| `breakdown` | enum | Opcional: `total`, `sex`, `area` (metropolitana, outra urbana, rural), `age_group`, `ethnicity`, `economic_activity` ou `occupational_category`. As linhas de atividade e categoria descrevem os ocupados. |
| `year_from` | integer | Primeiro ano opcional, inclusive. `0` não define limite. Por padrão `0`. |
| `year_to` | integer | Último ano opcional, inclusive. `0` não define limite. Por padrão `0`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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 }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Contribuintes do IGSS

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

Contribuintes por departamento, atividade e mês. O mês mais recente primeiro.

| Campo | Tipo | Notas |
| - | - | - |
| `department_code` | string | Código opcional do departamento, dois dígitos, `01` (Guatemala) a `22` (Jutiapa), na ordem em que o INE os numera. |
| `activity` | enum | Opcional: `agricultural`, `export_and_maquila`, `non_agricultural` (o resto do setor privado) ou `public`. |
| `from_date` | string | Opcional. Primeiro mês (`yyyy-mm-dd`, conta o mês em que cai). |
| `to_date` | string | Opcional. Último mês (`yyyy-mm-dd`, inclusive). |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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"
      }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Salário mínimo

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

O salário mínimo em quetzales por mês, nominal por ano e real por mês. O mais
recente primeiro.

| Campo | Tipo | Notas |
| - | - | - |
| `measure` | enum | Opcional: `nominal` (uma linha por ano e atividade, o salário em vigor) ou `real` (uma linha por mês, deflacionado pelo índice de preços ao consumidor). Ambos quando vazio. |
| `activity` | enum | Opcional: `agricultural`, `non_agricultural` ou `export_and_maquila` (publicado desde 2008). |
| `circumscription` | enum | Opcional: `CE1` (o departamento de Guatemala) ou `CE2` (os outros 21 departamentos). Só diferem em 2014 e desde 2023. |
| `year_from` | integer | Primeiro ano opcional, inclusive. `0` não define limite. Por padrão `0`. |
| `year_to` | integer | Último ano opcional, inclusive. `0` não define limite. Por padrão `0`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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 }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Risco de trabalho infantil

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

Os municípios de um departamento ou região, os de um nível de risco, ou
aqueles cujo nome coincide. A maior prevalência estimada primeiro.

| Campo | Tipo | Notas |
| - | - | - |
| `department_code` | string | Código opcional do departamento, dois dígitos, `01` (Guatemala) a `22` (Jutiapa), na ordem em que o INE os numera. |
| `region_code` | integer | Região opcional, 1 (Metropolitana) a 8 (Petén). `0` não filtra. Por padrão `0`. |
| `risk_level` | integer | Nível de risco nacional opcional, 1 (muito baixo) a 5 (muito alto). `0` não filtra. Por padrão `0`. |
| `query` | string | Palavras opcionais do nome do município ou do departamento, com ou sem acentos, p. ex. `coban`. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Relatórios e arquivos de dados

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

Os documentos que o Ministério publica, por palavras do título ou da seção. O
modificado mais recentemente primeiro.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais a buscar no título, na descrição ou na seção, p. ex. `empleador 2025`. |
| `format` | enum | Opcional: `pdf` (relatórios e boletins) ou `zip` (arquivos de dados e scripts). |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-500. Padrão `100`. Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`.

## Resposta

Cada resposta traz `as_of`: o quão atuais são os dados.

### Indicadores de trabalho (`results[]`)

| Campo | Notas |
| - | - |
| `series_id` | A identidade da linha: pesquisa, rodada, desagregação e categoria. |
| `survey`, `year`, `period`, `period_start` | A rodada da pesquisa: `ENEI` 2012-2022 (de uma a três rodadas por ano, "2019-2"), `ENCOVI` 2023, `ENEIC` trimestral desde 2024 ("2026-T1"). `period_start` ordena as rodadas. |
| `breakdown`, `category` | `total`, ou a dimensão e a categoria dentro dela, como a pesquisa a nomeia. |
| `population`, `working_age_population`, `labour_force`, `employed`, `unemployed`, `informal_employed`, `underemployed` | Pessoas ponderadas. |
| `working_age_share`, `participation_rate`, `employment_rate`, `unemployment_rate`, `informality_rate`, `underemployment_rate` | Percentual, duas casas decimais. |
| `average_income` | Renda mensal média do trabalho dos ocupados, em quetzales. |

### Contribuintes do 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` e `contributors`.

### Salário mínimo (`results[]`)

`wage_id`, `measure` (`nominal` por ano, `real` por mês), `period`, `period_start`,
`year`, `month`, `activity`, `activity_name`, `circumscription` (`CE1` o departamento
de Guatemala, `CE2` o resto) e `amount` em quetzales por mês.

### Risco de trabalho infantil (`results[]`)

`municipality_code` (os quatro dígitos do INE), `municipality`, `department_code`,
`department`, `region_code`, `region`, `children`, `children_in_child_labour`,
`prevalence` com `prevalence_lower` e `prevalence_upper` (percentual),
`standard_error`, `coefficient_of_variation`, `estimate_quality`,
`national_risk_level` e `national_risk` (1 a 5 frente ao país),
`regional_risk_level` e `regional_risk` (frente à região do município).

### Publicações (`results[]`)

`publication_id`, `title`, `description`, `headings[]` e `section` (onde a página
lista o arquivo), `file_name`, `format`, `bytes`, `modified_at`,
`source_document_url` (o link do Ministério), `document_url` (a cópia idêntica
byte a byte da Croma, sempre disponível) e `document_versions[]` quando o
Ministério substituiu o arquivo no mesmo link.

> [!NOTE]
>
> Os indicadores de trabalho são os números do próprio Ministério a partir das
> pesquisas domiciliares do INE. As rodadas não são estritamente comparáveis
> entre pesquisas: a ENEI, a ENCOVI e a ENEIC diferem em desenho e trabalho de
> campo, e os rótulos de atividade econômica e de grupo étnico seguem o codebook
> de cada pesquisa.

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


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