Skip to main content

Social Security Number Look Up

Description​

The Mexico NSS Lookup service allows businesses to locate or verify an individual's Número de Seguridad Social (NSS), Mexico's Social Security Number issued by the Instituto Mexicano del Seguro Social (IMSS).

The service uses the individual's CURP as the primary identifier, since CURP is the official key required by IMSS for NSS assignment or location.

HTTP method GET​

Endpoint​

https://api.msla-id.com/experience-idv-socialsecurity-api-v1/api/idv-govcheck/v1/mx-identity/valida-nss/{curp}
[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

URI request parameter​

NAMEREQUIREDTYPEDESCRIPTION
curp✅stringUnique Population Registry Code (CURP).

Status code responses​

CodeDescription
200 OK
400 Bad request
401 Unauthorized
404 Not found
500 Internal server error.
504 Gateway Timeout.

The full documentation error codes can be found here.

Response 200 status code​

{
    "traceId": "8846f1f94b015876",
    "timestamp": "2026-06-16 15:19:22",
    "data": {
        "nss": "67067300169",
        "messageKey": "0",
        "status": "OK",
        "validationCode": "gn1781641157.2585623"
    }
}

Response 400 status code​

{
   "traceId": "1859c523c96ac21b",
   "timestamp": "2026-06-16 16:29:54",
   "code": "IDV-NSS2001",
   "message": "The provided CURP is invalid.",
   "data": null
}

Response 401 status code​

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

Response 404 status code​

{
    "traceId": "6e428cb17b383d9b",
    "timestamp": "2026-06-16 16:31:56",
    "code": "IDV-1002",
    "message": "Data not found.",
    "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!",
  "data": null
}

Response 504 status code​

{
    "traceId": "68856541402f4913",
    "timestamp": "2026-06-16 16:12:38",
    "code": "IDV-NSS2001",
    "message": "Request to NSS service timed out.",
    "data": null
}