---
title: "Get Employments"
method: GET
path: "/employments/{identifier}"
tags: ["Individuals"]
---

# Get Employments

`GET /employments/{identifier}`

Retrieves the employment history for an individual identified by an 18-char CURP. Requires a prior successful verification that yielded employment data. Results can be paginated and filtered by employment period (`start_date`/`end_date`) and by last-update window (`updated_at_from`/`updated_at_to`). Each row exposes its own `updated_at` so consumers can tell how fresh each record is.

## Path parameters

- `identifier` string, required

## Query parameters

- `page` integer
- `items_per_page` integer
- `start_date` string, date
- `end_date` string, date
- `updated_at_from` string, date-time
- `updated_at_to` string, date-time
- `institution` 'imss' | 'issste'
- `data_source` string[]

## Response `200`

Employment history for the CURP (identifier).

- EmploymentHistoryResponse
  - `identifier` string — The identifier (CURP) associated with the employment history.
  - `updated_at` string, date-time — Timestamp of the last data update for this employment history.
  - `semanas_cotizadas` integer, nullable — Total number of contributed weeks. Null when the value is not available or when the identifier has no IMSS data.
  - `employment_history` EmploymentRecord[]
    - `employer` string — Name of the employer.
    - `employer_registration` string, nullable — Employer's registration number. May be null for certain institutions like ISSSTE.
    - `start_date` string, date — Start date of the employment.
    - `end_date` string, date, nullable — End date of the employment. Null if currently employed.
    - `federal_entity` string, nullable — The federal entity (e.g., state) where the employment is registered.
    - `base_salary` number — The base salary for the employment.
    - `monthly_salary` number — The calculated monthly salary.
    - `pdf_link` string, uri — A link to the PDF document for this employment record.
    - `institution` 'imss' | 'issste' | 'employment_sandbox' | 'invoices_sandbox' — The institution the employment is associated with.
    - `data_source` 'imss_rpci' | 'imss_get_weeks' | 'imss_rpci_archive' | 'imss_get_weeks_archive' | 'imss_app_scraping' | 'issste' | 'issste_archive' | 'employment_sandbox', nullable — The specific data source that provided this employment record.
    - `updated_at` string, date-time — Timestamp (ISO-8601 instant) of the last update for this individual employment record. Reflects per-row freshness and is the field filtered by the `updated_at_from`/`updated_at_to` query parameters.
  - `pagination` Pagination
    - `page` integer — The current page number.
    - `items_per_page` integer — The number of items returned per page.
    - `total_items` integer — The total number of items available.
    - `total_pages` integer — The total number of pages available.

## Other responses

- `400` — Bad Request - Invalid query parameters. Returned when `updated_at_from` is after `updated_at_to`.
- `401` — Unauthorized - Invalid or missing API key.
- `404` — No employment history found for the CURP (identifier), or no prior successful verification exists that yielded this data. Also returned when active filters (including `updated_at_from`/`updated_at_to`) exclude every record.

---

[API](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api.md) · [All operations](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/burodeingresos/bur-de-ingresos-api/versions/59e48cdbdd84/schema)