IMSS - Employment Information Product

Description

The IMSS employment dataset provides formal employment information associated with a Mexican social security record.

Core Data Elements:

• Social Security Number (NSS) and CURP correlation
• Employer registration and employer RFC
• Business name, state, and state code
• Base salary, modality, and contributed days
• Source period and report issue metadata

Purpose and Use:

• Verification of current formal employment information in Mexico
• Support for onboarding, underwriting, and compliance workflows
• Validation of employer and salary-related information
• Cross-check of social security identity and employment attributes

This product allows clients to validate employment-related information linked to an IMSS record in Mexico.

HTTP method POST

Endpoint

https://api.msla-id.com/experience-idv-socialsecurity-api-v1/api/idv-govcheck/v1/mx-imss/employment

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token
Content-Type	✅	string	application/json

Request body parameters

NAME	REQUIRED	TYPE	DESCRIPTION
curp	✅	string	Mexican ID official number.
nss	✅	string	Mexican Social Security Number (NSS).

Request body example

{
  "curp": "GOCS031114MMCLRLA0",
  "nss": "44190396042"
}

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.

The full documentation error codes can be found here.

Response 200 status code

{
  "traceId": "3eb16867841f4527",
  "timestamp": "2026-04-16 13:26:18",
  "data": {
    "socialSecurityNumber": "44190396042",
    "curp": "GOCS031114MMCLRLA0",
    "name": "SOLEDAD GLORIA CIRILO",
    "sex": "MUJER",
    "employmentInformation": {
      "employerRegistration": "Y5058324",
      "modality": "10",
      "employerRfc": "CVE201001NUA",
      "businessName": "CORPORATIVO VIAD EXPERTOS EN LIMPIEZA S DE RL DE CV",
      "state": "CIUDAD DE MEXICO",
      "stateCode": "9",
      "baseSalary": " $330.57",
      "days": "31"
    },
    "originationData": {
      "sourceMonth": "Marzo",
      "sourceYear": "2026",
      "sourceMonthInt": 3,
      "sourceYearInt": 2026,
      "reportIssueDate": "16/04/2026",
      "currentMonth": "Abril",
      "nextMonth": "Abril",
      "reportIssueYear": "2026",
      "nextReportMonth": "Mayo"
    }
  }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-4005",
    "message": "-",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/mx-imss/employment"
}

Response 404 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 404,
    "error": "Not Found",
    "path": "/api/idv-govcheck/v1/mx-imss/employment"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}

Notes

• This documentation describes the public endpoint exposed by experience.
• The endpoint expects JSON payloads with CURP and NSS in the request body.
• The response returns employment information directly in the response body.