Skip to main content

ISSSTE - Public Sector Labor Income Product

Description​

The ISSSTE labor income dataset applies to federal public-sector employees and is used to manage pension, savings, and social benefits.

Core Data Elements:
  • Pensionable salary (base salary for contributions)
  • Contribution history to retirement funds
  • Salary-based deductions and allocations
  • Employment tenure within public institutions
Purpose and Use:
  • Pension calculation and retirement planning
  • Determination of eligibility for public-sector benefits
  • Savings and retirement fund administration
  • Credit qualification (e.g., housing-related benefits)

This product reflects income data for government employees and is structured primarily around pension and long-term benefit calculations rather than general social security contributions.

Step 1 — Create ISSSTE verification ticket (ISSSTE TICKET)​

Creates an ISSSTE verification request using the provided CURP and returns a request identifier to track the asynchronous verification process.

HTTP method POST​

Endpoint​

https://api.msla-id.com/experience-idv-socialsecurity-api-v1/api/idv-govcheck/v1/mx-identity/issste-ticket
[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​

NAMEREQUIREDTYPEDESCRIPTION
Authorization✅stringbearer jwt token
Content-Type✅stringApplication/Json

Request body parameters​

{
    "curp": "AAOE720202MDFNRL09"
}
NAMEREQUIREDTYPEDESCRIPTION
curp✅stringMexican CURP used to validate NSS data.

Status code responses​

CodeDescription
200 OK
400 Bad request — DOM-3001
401 Unauthorized
403 Forbidden — IDV-1004
500 Internal server error — IDV-1008
504 Gateway timeout — IDV-IST1008

The full documentation error codes can be found here.

Response 200 status code​

{
    "traceId": "35f34a6de6cf095c",
    "timestamp": "2026-04-20 10:08:07",
    "data": {
        "requestId": "56ebda5f-d2c4-4d3e-b4ef-03a0a48300a7",
        "status": "PENDING"
    }
}

Response 400 status code​

{
    "traceId": "7c6832744d1658ab",
    "timestamp": "2024-01-29 16:48:27",
    "code": "DOM-3001",
    "message": "Error in the call to the supplier",
    "data": null
}

Note: This error occurs when there are problems with the supplier. Verify the supplier connection and ensure that the request is correctly formatted.

Response 403 status code​

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1004",
    "message": "Forbidden",
    "data": null
}

Response 500 status code​

{
    "traceId": "86c6eda02b615604",
    "timestamp": "2024-01-09 15:44:32",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administrator!"
}

Response 504 status code​

{
    "traceId": "86c6eda02b615604",
    "timestamp": "2024-01-09 15:44:32",
    "code": "IDV-IST1008",
    "message": "Request to ISSSTE service timed out"
}

Step 2 — Retrieve ISSSTE verification result (ISSSTE REPORT)​

Retrieves the status and, when available, the ISSSTE verification result associated with the specified request identifier.

HTTP method GET​

Endpoint​

https://api.msla-id.com/experience-idv-socialsecurity-api-v1/api/idv-govcheck/v1/mx-identity/issste/{TICKET}

Request header parameter​

NAMEREQUIREDTYPEDESCRIPTION
Authorization✅stringbearer jwt token
Content-Type✅stringApplication/Json

URI request parameter​

NAMEREQUIREDTYPEDESCRIPTION
TICKET✅stringUnique ticket code.

Process Status​

  • PENDING: Ticket created, awaiting processing
  • PROCESSING: Request currently being processed
  • SUCCESS: Process completed successfully, report available
  • FAILED: Process failed, no report generated

Status code responses​

CodeDescription
200 OK
401 Unauthorized
403 Forbidden — IDV-1004
404 Not found — IDV- IST1002 Ticket not found.
500 Internal server error — IDV-1008
504 Gateway timeout — IDV-1100

Response 200 status code​

SUCCESS:

{
    "traceId": "fd1e96e3f7ec584f",
    "timestamp": "2026-07-01 16:45:57",
    "data": {
        "status": "SUCCESS",
        "message": "Completed",
        "socialSecurityNumber": "80077221283",
        "curp": "AAOE720202MDFNRL09",
        "name": "ELIZABETH DE ANDA ORTEGA",
        "gender": "MUJER",
        "employmentInformation": {
            "employerRegistration": "",
            "employmentModality": "TODOS LOS SEGUROS, PRESTACIONES Y SERVICIOS",
            "employerRfc": "AAOE720202GC0",
            "companyName": "PLF. AUDITORIA SUPERIOR DE LA FEDERACION",
            "federalEntity": "CIUDAD DE MEXICO",
            "baseSalary": "$27,134.60",
            "days": "31"
        },
        "reportOriginData": {
            "originMonth": "julio",
            "originYear": "2026",
            "originMonthInt": 7,
            "originYearInt": 2026,
            "reportIssueDate": "01/07/2026",
            "currentMonth": "julio",
            "nextMonth": "agosto",
            "reportIssueYear": "2026",
            "nextReportMonth": "agosto"
        }
    }
}

PROCESSING:

{
    "traceId": "72a998a62bc0f4cd",
    "timestamp": "2026-03-09 08:15:00",
    "data": {
        "status": "PROCESSING",
        "message": " Processing."
    }
}

FAILED (Invalid CURP):

{
    "traceId": "72a998a62bc0f4cd",
    "timestamp": "2026-03-09 08:15:00",
    "data": {
        "status": "FAILED",
        "message": "CURP validation failed."
    }
}

CURP record not found:

{
    "traceId": "72a998a62bc0f4cd", 
    "timestamp": "2026-03-09 08:15:00",
    "data": {
       "status": "FAILED",
        "message": "Data not Found."
    }
}

Service unavailable.:

{
    "traceId": "72a998a62bc0f4cd", 
    "timestamp": "2026-03-09 08:15:00",
    "data": {
        "status": "FAILED",
        "message": "Supplier unavailable."
    }
}

Timed out:

{
    "traceId": "72a998a62bc0f4cd", 
    "timestamp": "2026-03-09 08:15:00",
    "data": {
        "status": "FAILED",
        "message": "Supplier timeout."
    }
}

Response 404 status code​

{
    "traceId": "c3c48a6057bb0cbc",
    "timestamp": "2026-04-20 11:11:48",
    "code": "IDV- IST1002",
    "message": "Ticket not found.",
    "data": null
}

Note: The ticket does not exist or was not found.

Response 403 status code​

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1004",
    "message": "Forbidden",
    "data": null
}

Response 500 status code​

{
    "traceId": "86c6eda02b615604",
    "timestamp": "2024-01-09 15:44:32",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administrator!"
}

Response 504 status code​

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}