> ## 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 Labour Indicators > Guatemala's labour market indicators from the INE household surveys as the Ministry of Labour publishes them (ENEI 2012-2022, ENCOVI 2023, quarterly ENEIC since 2024): working-age population, labour force, employed, unemployed, informal and underemployed with their rates and the average labour income, for the whole country and by sex, area, age group, ethnic group, economic activity and occupational category. Filter by survey, breakdown and years. Newest round first. Served by Croma (`as_of` says how current the data is). **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## OpenAPI ````yaml /api-reference/openapi.json post /gt/mintrabajo-gt/labour-indicators/v1 openapi: 3.1.0 info: title: Croma Marketplace API version: 1.0.0 description: >- Government-data APIs for Colombia, Peru, Mexico, United States, Brazil, El Salvador, Bolivia, Japan, Chile, Venezuela, and Guatemala, plus global web search. Croma normalizes public-sector data into structured JSON for product teams and AI agents. Every operation is a POST with a JSON body and an organization API key as a bearer token; every operation is an idempotent lookup and accepts an optional `Idempotency-Key` header. Paths carry their major version (`/v1`); the versioning and deprecation policy, including the `Deprecation` and `Sunset` headers a retiring endpoint sends, is at https://docs.usecroma.com/versioning. Rate limits are per organization and reported on every response (`RateLimit-Policy`, `X-RateLimit-*`): https://docs.usecroma.com/rate-limits. termsOfService: https://usecroma.com/en/terms contact: name: Croma support url: https://usecroma.com/en/support email: support@usecroma.com servers: - url: https://api.croma.run security: [] paths: /gt/mintrabajo-gt/labour-indicators/v1: post: tags: - Guatemala - Mintrabajo summary: Mintrabajo Labour Indicators description: >- Guatemala's labour market indicators from the INE household surveys as the Ministry of Labour publishes them (ENEI 2012-2022, ENCOVI 2023, quarterly ENEIC since 2024): working-age population, labour force, employed, unemployed, informal and underemployed with their rates and the average labour income, for the whole country and by sex, area, age group, ethnic group, economic activity and occupational category. Filter by survey, breakdown and years. Newest round first. Served by Croma (`as_of` says how current the data is). **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. operationId: mintrabajo_gt_labour_indicators parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: type: object required: [] properties: survey: type: string enum: - '' - ENEI - ENEIC - ENCOVI default: '' description: >- Optional survey: `ENEI` (2012-2022), `ENEIC` (quarterly since 2024) or `ENCOVI` (2023). breakdown: type: string enum: - '' - total - sex - area - age_group - ethnicity - economic_activity - occupational_category default: '' description: >- Optional breakdown: `total`, `sex`, `area`, `age_group`, `ethnicity`, `economic_activity` or `occupational_category`. year_from: type: integer minimum: 0 maximum: 2100 default: 0 description: Optional first year (inclusive). 0 sets no lower bound. year_to: type: integer minimum: 0 maximum: 2100 default: 0 description: Optional last year (inclusive). 0 sets no upper bound. page: type: integer minimum: 1 maximum: 1000 default: 1 description: 1-based page number for paginated results. per_page: type: integer minimum: 1 maximum: 500 default: 100 description: Results per page (1-500). additionalProperties: false example: breakdown: sex year_from: 2024 responses: '200': description: Successful response headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' X-Cache: $ref: '#/components/headers/X-Cache' content: application/json: schema: $ref: '#/components/schemas/MintrabajoGtLabourIndicatorsResponse' '400': description: Invalid request body headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Missing or invalid API key headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '502': description: Upstream source returned an error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearerAuth: [] externalDocs: description: Interactive documentation and examples url: https://docs.usecroma.com/guides/guatemala/mintrabajo components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false description: >- Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the `Idempotency-Key` response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit. schema: type: string maxLength: 255 example: 0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b headers: X-Request-Id: description: Unique id for the request (req_…). Include it in support reports. schema: type: string RateLimit-Policy: description: >- Quota policy for this endpoint as an IETF RateLimit-Policy structured field, e.g. `"default";q=100;w=86400` (100 requests per 86400-second window per organization). Endpoints with an extra hourly ceiling list both policies, e.g. `"webSearch";q=100;w=3600, "default";q=100;w=86400`. Present on every response, including 401 and 429. schema: type: string example: '"default";q=100;w=86400' Idempotency-Key: description: >- The `Idempotency-Key` the request carried, echoed back unchanged. Absent when the request sent none. schema: type: string Deprecation: description: >- Present only on an endpoint version scheduled for removal: the date the deprecation took effect (RFC 9745). A `Sunset` header and a `Link` with `rel="successor-version"` accompany it. Policy: https://docs.usecroma.com/versioning schema: type: string example: '@1767225600' Sunset: description: >- Present only on an endpoint version scheduled for removal: the date after which it answers 410 (RFC 8594). Announced in the changelog at least 90 days ahead. schema: type: string format: date-time example: Wed, 01 Apr 2026 00:00:00 GMT X-RateLimit-Limit: description: Requests allowed in the current window. schema: type: integer X-RateLimit-Remaining: description: Requests left before you are throttled. schema: type: integer X-RateLimit-Reset: description: ISO 8601 timestamp when the window resets. schema: type: string format: date-time X-Cache: description: >- HIT or MISS. Cached hits spend no credits, but still count toward an hourly ceiling. schema: type: string enum: - HIT - MISS Retry-After: description: Seconds to wait before retrying. schema: type: integer schemas: MintrabajoGtLabourIndicatorsResponse: type: object required: - data properties: data: $ref: '#/components/schemas/MintrabajoGtLabourIndicatorsData' ApiError: type: object required: - error properties: error: type: object required: - type - code - message properties: type: type: string description: >- Broad category: invalid_request_error, authentication_error, not_found_error, rate_limit_error, upstream_error, api_error. code: type: string description: Machine-readable specific code. message: type: string description: Human-readable explanation, safe to surface in UI. param: type: string description: Field that triggered the error. Present on validation errors. details: type: object description: Free-form structured detail. MintrabajoGtLabourIndicatorsData: type: object properties: as_of: anyOf: - type: string - type: 'null' description: How current the data in this response is. survey: anyOf: - type: string - type: 'null' breakdown: anyOf: - type: string - type: 'null' year_from: anyOf: - type: number - type: 'null' year_to: anyOf: - type: number - type: 'null' total: type: number description: Matches, counted up to 1000. total_is_exact: type: boolean description: False when more than 1000 match. page: type: number per_page: type: number total_pages: type: number count: type: number results: type: array items: type: object properties: series_id: type: string description: >- The row: survey, round, breakdown and category, e.g. "ENEIC:2026-T1:sex:Mujer". survey: type: string enum: - ENEI - ENEIC - ENCOVI description: >- `ENEI` (2012-2022), `ENEIC` (quarterly since 2024-T4) or `ENCOVI` (2023). year: type: number description: The year of the round. period: type: string description: >- The round as the Ministry labels it: "2019-2" (ENEI round 2), "2026-T1" (ENEIC first quarter), "2023" (one round that year). period_start: type: string description: >- `yyyy-mm-dd`: the first day of the round's quarter, or of its slot within the year for the ENEI rounds. What the results are ordered by. breakdown: type: string enum: - total - sex - area - age_group - ethnicity - economic_activity - occupational_category description: >- `total` for the whole population, or the dimension `category` splits it by. category: anyOf: - type: string - type: 'null' description: >- The category within `breakdown`, as the survey labels it ("Mujer", "Rural nacional", "15 a 24", "Maya", an economic activity, an occupational category). Null for `total`. population: anyOf: - type: number - type: 'null' description: Everyone in the category, weighted persons. working_age_population: anyOf: - type: number - type: 'null' description: People aged 15 or more (PET), weighted persons. working_age_share: anyOf: - type: number - type: 'null' description: PET over the population, percent with two decimals. labour_force: anyOf: - type: number - type: 'null' description: >- The economically active population (PEA): employed plus unemployed, weighted persons. participation_rate: anyOf: - type: number - type: 'null' description: PEA over PET, percent with two decimals. employed: anyOf: - type: number - type: 'null' description: People in work, weighted persons. employment_rate: anyOf: - type: number - type: 'null' description: Employed over PEA, percent with two decimals. unemployed: anyOf: - type: number - type: 'null' description: People without work and looking, weighted persons. unemployment_rate: anyOf: - type: number - type: 'null' description: Unemployed over PEA, percent with two decimals. informal_employed: anyOf: - type: number - type: 'null' description: Employed in the informal sector, weighted persons. informality_rate: anyOf: - type: number - type: 'null' description: Informal over employed, percent with two decimals. underemployed: anyOf: - type: number - type: 'null' description: >- Visibly underemployed: working fewer hours than wanted, weighted persons. underemployment_rate: anyOf: - type: number - type: 'null' description: Underemployed over PEA, percent with two decimals. average_income: anyOf: - type: number - type: 'null' description: >- Average monthly labour income of the employed, quetzales with two decimals. required: - series_id - survey - year - period - period_start - breakdown - category - population - working_age_population - working_age_share - labour_force - participation_rate - employed - employment_rate - unemployed - unemployment_rate - informal_employed - informality_rate - underemployed - underemployment_rate - average_income required: - as_of - survey - breakdown - year_from - year_to - total - total_is_exact - page - per_page - total_pages - count - results securitySchemes: bearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer YOUR_API_KEY' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.