Sign in

v1

latestOpenAPI 3.0.32026-07-242644125.9 KB
Individuals

Get Employments

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.

get/employments/{identifier}

Path parameters

identifierstring required
Example:CUAI911021MOCRQS09

The CURP of the individual.

Query parameters

pageinteger

Page number for pagination.

items_per_pageinteger

Number of items per page.

start_datestring date
Example:2020-01-01

Optional. Filters employment records to include those where the employment period overlaps with or starts on/after this date (YYYY-MM-DD).

end_datestring date
Example:2025-12-31

Optional. Filters employment records to include those where the employment period overlaps with or ends on/before this date (YYYY-MM-DD).

updated_at_fromstring date-time
Example:2026-01-01

Optional. Filters employment records to include those last updated on/after this date, by their updated_at (YYYY-MM-DD).

updated_at_tostring date-time
Example:2026-03-31

Optional. Filters employment records to include those last updated on/before this date, by their updated_at (YYYY-MM-DD). If updated_at_from is after updated_at_to, the request fails with HTTP 400.

institution'imss' | 'issste'
Example:imss

Optional. Filters employment records by institution. If not provided, records from all institutions are returned.

data_sourcestring[]

Optional. Filters employment records by one or more specific data sources. Can be repeated to include multiple sources (e.g. ?data_source=imss_rpci&data_source=imss_get_weeks). If not provided, the highest-priority source per institution is returned.

[
  "imss_rpci"
]

Response

Employment history for the CURP (identifier).

identifierstring

The identifier (CURP) associated with the employment history.

updated_atstring date-time

Timestamp of the last data update for this employment history.

semanas_cotizadasinteger nullable

Total number of contributed weeks. Null when the value is not available or when the identifier has no IMSS data.