Employments

Two endpoints expose this data:

GET /employments/{identifier} — structured employment history
GET /employment-files/{identifier} — downloadable PDF documents from IMSS and ISSSTE

For the high-level field reference of the Individual response, see Individual Data.

Employment history

Available from GET /employments/{identifier}. Returns the individual's employment history as reported by IMSS and ISSSTE.

Field Name	Type	Description	Example	Notes
`identifier`	`string`	18-char CURP of the individual.	`"CUAI911021MOCRQS09"`	Same as the verification identifier.
`updated_at`	`string` (ISO 8601)	When the data was last updated.	`"2025-09-10T17:40:22.153499Z"`	UTC.
`semanas_cotizadas`	`number` or `null`	Total weeks paid into IMSS.	`447`	May be null. Proxy indicator of how long the individual has been in formal employment.
`employment_history`	`array[object]`	Array of employment records.	See below.	One entry per employer-period combination. Empty array if no data.
`pagination`	`object`	Pagination metadata.	Standard pagination object.

Employment Object

Each item in employment_history:

Field Name	Type	Description	Example	Notes
`employer`	`string`	Company name.	`"CONSTRUCCIONES YAMILE"`
`employer_registration`	`string`	IMSS employer registration code.	`"Y606341210"`	May be null for ISSSTE records.
`start_date`	`string` (date)	Employment start date.	`"2020-02-22"`	YYYY-MM-DD.
`end_date`	`string` (date)	Employment end date.	`"2022-02-15"`	`null` means the individual is currently employed.
`federal_entity`	`string`	State or region of employment.	`"CIUDAD DE MÉXICO"`	May be null for certain ISSSTE records.
`base_salary`	`number`	Daily salary reported by IMSS.	`116.02`	In MXN.
`monthly_salary`	`number`	Calculated monthly salary.	`3529.33`	In MXN. Derived from `base_salary`.
`pdf_link`	`string` (URL)	Link to the source PDF.	`"https://link_to_pdf.com"`	May be null. Same PDFs are also exposed under `/employment-files/{identifier}`.
`institution`	`string`	Source institution.	`"imss"` or `"issste"`

Employment files

Available from GET /employment-files/{identifier}. Returns downloadable PDF documents issued by IMSS and ISSSTE that serve as official proof of employment and contribution history.

Field Name	Type	Description	Example	Notes
`identifier`	`string`	CURP associated with the files.	`"MAPE850312HDFRRR02"`	Same as the verification identifier.
`employment_files`	`array[object]`	Array of employment document files.	See below.	Empty array if no files available.

Employment File Object

Each item in employment_files:

Field Name	Type	Description	Example	Notes
`url`	`string` (URL)	Pre-signed download URL.	`"https://palencabdiproductionst.blob.core.windows.net/...?sv..."`	Expires after 15 minutes.
`name`	`string`	Document name.	`"Constancia de Semanas Cotizadas en el IMSS"`	Human-readable label.
`institution`	`string`	Source institution.	`"imss"` or `"issste"`	Government agency that issued the document.
`uploaded_at`	`string` (ISO 8601)	When the file was generated.	`"2025-10-02T01:23:41Z"`	UTC.

Document types

Institution	Document Name	Description
`imss`	Constancia de Semanas Cotizadas en el IMSS	Full employment history as reported to IMSS.
`imss`	Reporte de Cotización al IMSS	Current employment status and salary as reported to IMSS.
`imss`	Constancia de No Derechohabiente	Certificate that the individual is not registered in IMSS.
`issste`	Expediente Electrónico Único del ISSSTE	Unique electronic file from ISSSTE.

Notes

Employment status is derived from this data and exposed in the Individual profile (employed, retired, unemployed, unknown). See Individual Data for the profile object.
PDF URL expiration: the url field is a pre-signed URL that expires after 15 minutes. The encoded se parameter in the URL indicates the expiration timestamp.
Multiple files per verification: depending on the data found for the identifier, the same verification can return multiple files from IMSS and ISSSTE.
Cross-reference with /employments: the pdf_link field inside an Employment Object points to the same documents listed in /employment-files/{identifier}.