Employment Status
Credits: 1 per call.
Returns the current IMSS employment status of a worker (identified by CURP + NSS): whether they are currently registered as employed, inactive (no current registration), the modality of registration, the registered employer’s RFC, employer name, state, base salary, contributed days, and the period the IMSS report covers.
Use this endpoint for income verification (lending, leasing), employment confirmation (background checks), or to detect overlapping employment when complying with employment regulations.
Set includePdf: true to also receive the official IMSS report as a PDF in data.files[] (kind: document, base64) — no extra credits. reportDetails describes that report: reportPeriod (month the report covers), issueDate, currentMonth (current month according to IMSS, the month of issueDate) and nextReportMonth (month in which IMSS will publish the next report).
First-time CURPs: for a CURP queried for the first time, use Employment Status (Async) — the synchronous lookup can answer SERVICE_UNAVAILABLE for it.
Body
Response
Business Responses (Strict Envelope Pattern).