← Catálogo
IMSS1 tokenPOST

Número de Seguridad Social

Consulta el Número de Seguridad Social asociado a una CURP en el IMSS. Útil para validar la afiliación de una persona y completar procesos de KYC laboral.

Endpoint

POSThttps://api.datosnonstop.com/v1/imss/nss

Parámetros

json
{
  "curp": "ROPG750823MGRDZL09"
}
ParámetroTipoRequeridoDescripción
curpstringSíCURP de 18 caracteres a consultar

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl
curl -X POST https://api.datosnonstop.com/v1/imss/nss \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"curp":"ROPG750823MGRDZL09"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON
200 OK
{
  "id": "6a3b865g4d8f1c5a9e27b041",
  "status": "found",
  "curp": "ROPG750823MGRDZL09",
  "nss": "15937547827",
  "nombres": "LORENA PATRICIA",
  "apellidoPaterno": "ROMO",
  "apellidoMaterno": "DELGADO",
  "fechaNacimiento": "1975-08-23",
  "sexo": "MUJER"
}

Respuestas en error

JSON
400 Bad Request
[
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "curp"
  }
]

Campos

Campos de entrada

CampoTipoDescripción
curpstringCadena alfanumérica de 18 caracteres que identifica de forma única a una persona ante RENAPO.

Campos de respuesta

CampoTipoDescripción
idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.
statusstringResultado de la consulta del NSS en el IMSS. Ver catálogo Status.
curpstringCURP consultada (18 caracteres).
messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found. Ver catálogo Mensajes not_found.
nssstringNúmero de Seguridad Social asignado por el IMSS (11 dígitos). Solo está presente cuando status es found.
nombresstringNombres de pila del asegurado registrados en RENAPO.
apellidoPaternostringApellido paterno del asegurado.
apellidoMaternostringApellido materno del asegurado.
fechaNacimientostringFecha de nacimiento en formato ISO YYYY-MM-DD.
sexostringSexo registrado en RENAPO. Ver catálogo Sexo.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción
foundSe encontró un NSS asociado a la CURP. La respuesta incluye los datos del asegurado.
not_foundNo se encontró un NSS asociado a la CURP. La respuesta incluye el campo message con el detalle.

Mensajes not_found

Mensajes posibles del campo message cuando status es not_found.

MensajeDescripción
No se encontro un numero asociado a la CURPLa CURP existe en RENAPO pero el IMSS no tiene un NSS asociado a ella.
No se localizo informacion en RENAPO con la CURP capturada.La CURP no existe en los registros de RENAPO, por lo que el IMSS no puede validarla.
Tu solicitud requiere que acudas a la subdelegación.La consulta no puede resolverse en línea; el titular debe acudir presencialmente a una subdelegación del IMSS.
La CURP ha sido consultada más de dos veces en un periodo de 24 horas, favor de intentar más tardeEl IMSS limita la frecuencia de consultas por CURP. Espera a que termine la ventana de 24 horas para reintentar.

Sexo

Valores posibles del campo sexo.

ValorDescripción
HOMBREPersona registrada como hombre.
MUJERPersona registrada como mujer.
NO BINARIOPersona registrada con identidad de género no binaria.

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/imss/nss/historico/{id}

El {id} corresponde al campo id devuelto en la respuesta de la consulta principal.

Si necesitas la lista completa de elementos almacenados, accede a tu dashboard.

La respuesta está sujeta al tiempo de almacenamiento de tu plan. Si requieres más tiempo, cambia de plan en tu dashboard.

Respuesta

JSON
200 OK
{
  "id": "6a3b865g4d8f1c5a9e27b041",
  "status": "found",
  "curp": "ROPG750823MGRDZL09",
  "nss": "15937547827",
  "nombres": "LORENA PATRICIA",
  "apellidoPaterno": "ROMO",
  "apellidoMaterno": "DELGADO",
  "fechaNacimiento": "1975-08-23",
  "sexo": "MUJER"
}

Respuestas en error

JSON
404 Not Found
[
  {
    "type": "not_found",
    "message": "el id no fue encontrado en el historico"
  }
]

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/imss/nss

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl
curl -X POST https://sandbox.api.datosnonstop.com/v1/imss/nss \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"curp":"ROPG750823MGRDZL09"}'

Casos de prueba

Si envías un valor de CURP que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de ROPG750823MGRDZL09.

CasoCURP
Caso exitoso — EncontradoROPG750823MGRDZL09
No encontrado — Sin NSS asociado a la CURPGAMR800101HDFRRL05
No encontrado — Sin info en RENAPOHEPA920215MDFLLN03
No encontrado — Acudir a subdelegaciónLOCB880430HDFPSR07
No encontrado — Límite de consultas en 24hMARQ770612MJCRBT09
Sin tokensAAAB801109HAAABS04
Error internoBBBC691225MBBBBV05
Unavailable serviceDDDE540630HDDDDF06

Endpoint histórico

GEThttps://sandbox.api.datosnonstop.com/v1/imss/nss/historico/{id}

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl
curl https://sandbox.api.datosnonstop.com/v1/imss/nss/historico/6a3b865g4d8f1c5a9e27b041 \
  -H "x-api-key: tu_api_key_sandbox"

Casos de prueba histórico

Si envías un valor de id que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 6a3b865g4d8f1c5a9e27b041.

Casoid
Caso exitoso6a3b865g4d8f1c5a9e27b041
No encontrado0000000000000000ffffffff
Fuera de rango1111111111111111aaaaaaaa
Error interno2222222222222222bbbbbbbb
Empezar gratis →