¿Se puede obtener el NSS de una persona con su CURP?

Sí. El API de OrigoID consulta al IMSS con la CURP y devuelve el Número de Seguridad Social de 11 dígitos en la misma respuesta. Es una llamada síncrona: no hay folio que consultar después ni webhook que esperar.

¿Qué pasa si la persona no tiene NSS?

La respuesta lo dice de forma explícita con el código PERSON_WITHOUT_NSS: la CURP existe, pero no tiene un Número de Seguridad Social asignado. Es información útil, no un error: suele significar que esa persona nunca ha sido dada de alta ante el IMSS.

¿Para qué sirve consultar el NSS?

Para dos cosas: dar de alta a alguien en nómina o seguridad social sin pedirle la tarjeta del Seguro Social, que casi nadie encuentra; y como paso previo a la verificación de empleo ante el IMSS, que requiere CURP y NSS juntos.

¿La consulta de NSS es síncrona?

Sí. Mandas la CURP y el NSS viene en la respuesta de esa misma petición HTTP. No hay folios, ni colas, ni webhooks que configurar: toda la API de OrigoID funciona así.

IMSS · Consultar NSS

La CURP la tienes. El NSS te lo damos.

Deja de pedirle a tu usuario la tarjeta del Seguro Social, que casi nadie encuentra. Mandas su CURP y recibes su Número de Seguridad Social en la respuesta de esa misma llamada.

Solicitar acceso → Ver documentación ›

entrada: solo CURPrespuesta síncrona1 crédito por consulta

¿Dudas técnicas? Habla con un ingeniero por WhatsApp — 0% bots.

consulta-nssEJEMPLOS DEL API

Elige un escenario y mira qué recibe tu sistema:

Datos ficticios con la misma estructura que regresa el API. Ninguno corresponde a una persona real.

Dónde encaja

El dato que siempre falta, sin pedírselo a nadie.

El NSS son once dígitos que casi nadie se sabe de memoria y que viven en una tarjeta que casi nadie encuentra. Pedirlos en un formulario cuesta abandono; reconstruirlos a mano cuesta tiempo. La CURP, en cambio, ya la tienes.

◈

Alta en nómina y seguridad socialDas de alta a la persona sin pedirle documentos extra. Menos fricción en el onboarding y menos capturas a mano que salen mal.

⚑

Paso previo a verificar empleoLa verificación de empleo ante el IMSS necesita CURP y NSS juntos. Si solo tienes la CURP, esta consulta completa el par y encadenas las dos llamadas.

⊘

Menos datos pedidosCada campo que quitas de tu formulario es gente que sí termina el registro. Y es un dato sensible menos que tú tienes que guardar y proteger.

Casos de negocio

Cuando no hay NSS, te lo dice.

Ninguna respuesta te deja adivinando. El campo type nombra el caso con un código estable y tu backend decide con un switch.

type	Qué pasó	Qué hacer
`SUCCESS`	Se encontró el NSS de la persona. Vienen los 11 dígitos.	Avanza. Úsalo para el alta o para encadenar la verificación de empleo.
`PERSON_WITHOUT_NSS`	La CURP existe, pero no tiene un NSS asignado.	Analiza. Normalmente significa que nunca ha sido dada de alta ante el IMSS. No es un error del dato que capturaste.
`CURP_NOT_FOUND`	El IMSS no localizó esa CURP.	Analiza. Verifica la CURP contra RENAPO antes de concluir algo.
`IMSS_INCONSISTENT_DATA`	La CURP existe, pero sus datos están inconsistentes del lado del IMSS.	Analiza. El dato no es utilizable hasta que la persona lo corrija ante el instituto.
`IMSS_OPERATION_LIMIT`	Se alcanzó el límite diario de operaciones del IMSS.	Reintenta más tarde. No tiene que ver con los datos de tu usuario.
`SERVICE_UNAVAILABLE`	El IMSS no está respondiendo en este momento.	Reintenta. Llega con `billable: false`: no se te cobra.
`INVALID_REQUEST`	La CURP viene mal formada.	Corrige la captura. También llega con `billable: false`.

Infraestructura cruda · 100% API REST

Una llamada. Un dato de entrada.

Mandas la CURP y la respuesta trae el NSS. Mismo envelope que todos los servicios de OrigoID: aprendes el contrato una vez y te sirve para IMSS, CURP, INE, RFC y más.

Síncrono, no por lotesEl NSS viene en la respuesta de tu petición. Sin folios que consultar después, sin webhooks que configurar, sin archivos que subir y esperar.

Sin NSS también es respuestaPERSON_WITHOUT_NSS te dice que esa persona no tiene uno asignado — información, no un silencio.

Cero retenciónLa consulta se valida, se responde y se descarta. Sin guardar los datos, en ninguna región.

Ver documentación ↗

consulta-nss
          
          
          
        
const res = await fetch("https://api.origoid.com/mex/social-security/v1/imss-nss-lookups", {
  method: "POST",
  headers: {
    "x-api-key": process.env.ORIGOID_API_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({ curp: "XEXX010101HNEXXXA4" }),
});

const result = await res.json();import os, requests

res = requests.post(
    "https://api.origoid.com/mex/social-security/v1/imss-nss-lookups",
    headers={"x-api-key": os.environ["ORIGOID_API_KEY"]},
    json={"curp": "XEXX010101HNEXXXA4"},
    timeout=60,
)
result = res.json()curl -X POST https://api.origoid.com/mex/social-security/v1/imss-nss-lookups \
  -H "x-api-key: $ORIGOID_API_KEY" \
  -H "content-type: application/json" \
  -d '{"curp": "XEXX010101HNEXXXA4"}'Respuesta con el NSS
{
  "status": "OK",
  "type": "SUCCESS",
  "message": "NSS found",
  "data": { "nss": "00000000000" },
  "transactionId": "c5841679-321e-4b05-8d0b-42c457f79e31",
  "billable": true
}

Por qué OrigoID

Una llamada que responde, no un proceso que esperas.

Muchos proveedores resuelven este dato por lotes: subes un archivo y recoges resultados más tarde. Eso no cabe en un onboarding donde la persona está esperando del otro lado de la pantalla.

◈

Síncrono, en la misma llamadaUna petición HTTP, una respuesta con el dato. Sin folios, sin colas, sin webhooks. Toda la API funciona así.

⚑

Nunca un silencioSi no hay NSS asignado, si la CURP no está localizada o si el dato es inconsistente, la respuesta lo nombra con un código estable.

⊘

Cero retenciónLa consulta se valida, se responde y se descarta. Sin guardar los datos: el NSS de tu usuario no se queda con nosotros.

Precios publicados1 consulta = 1 crédito, y el precio por crédito baja con tu volumen. Todo público, sin "contáctanos". Ver precios

OrigoID no es el IMSS ni actúa en su nombre: es un medio técnico de consulta y cotejo respecto de esa fuente. La exactitud y la vigencia de la información dependen del propio instituto.

Preguntas frecuentes

Lo que suelen preguntarnos.

¿Se puede obtener el NSS solo con la CURP?

Sí. Mandas la CURP y recibes el Número de Seguridad Social de 11 dígitos en la misma respuesta. No necesitas la tarjeta ni ningún otro dato de la persona.

¿Y si la persona no tiene NSS?

La respuesta lo dice con PERSON_WITHOUT_NSS: la CURP existe pero no tiene un NSS asignado, lo que normalmente significa que nunca ha sido dada de alta ante el IMSS. Es información útil para tu proceso, no un error.

¿Es síncrono o por lotes?

Síncrono. El NSS viene en la respuesta de tu petición HTTP: sin folios que consultar después, sin webhooks que configurar y sin archivos que subir. Toda la API de OrigoID funciona igual.

¿Para qué lo usan nuestros clientes?

Para dar de alta personas en nómina o seguridad social sin pedir documentos extra, y como paso previo a la verificación de empleo, que necesita CURP y NSS juntos.

¿Guardan los datos de la consulta?

No. Cada consulta se valida, se responde y se descarta, sin guardar los datos. Cero retención en todas nuestras regiones.

¿Cuánto cuesta?

1 crédito por consulta. Empiezas con créditos de cortesía y el precio por crédito baja con tu volumen; todos los planes están publicados.