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

# Get Employments

`GET /employments/{identifier}`

## Request

- Base URL: `https://api.burodeingresos.com`
- URL: `https://api.burodeingresos.com/employments/{identifier}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/docs/employments/:identifier/get.ts> (a function with typed inputs; its response is checked against the schema)

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
- `updated_at_to` string, date
- `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 (IMSS). Present only when the employment history includes IMSS records; null when the value is not available.
  - `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_semanas_cotizadas' | '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.

## Changes

- **2026-11-03** `98eb3984cffb`: 2 breaking, 2 warning, 3 info
  - for the `query` request parameter `updated_at_from`, the format changed from `date-time` to `date`
  - for the `query` request parameter `updated_at_to`, the format changed from `date-time` to `date`
  - for the `query` request parameter `items_per_page`, the max was set to `100.00`
  - added the new `imss_semanas_cotizadas` enum value to the `employment_history/items/data_source` response property for the response status `200`
  - …3 more

[Operation history](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/changes/employments/:identifier/get.md)

---

[API](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api.md) - [All operations](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/llms.txt) - [OpenAPI document](https://skmtc.dev/burodeingresos/apis/bur-de-ingresos-api/revisions/98eb3984cffb?raw)