IMSS · API

El IMSS por API: empleo, semanas cotizadas y NSS.

Tres consultas al IMSS con un solo dato de entrada: la CURP. Saber si una persona trabaja hoy, ver su trayectoria laboral completa u obtener su Número de Seguridad Social, con la respuesta estructurada y lista para tu sistema.

Solicitar acceso → Ver documentación ›

entrada: solo la CURPresultado a tu webhooktres servicios, un mismo contrato

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

imssLOS TRES SERVICIOS

Elige qué necesitas saber:

Los tres reciben la CURP y entregan el resultado a tu webhook.

¿Cuál necesito?

Tres preguntas distintas, tres servicios.

Los tres consultan al IMSS y los tres parten de la CURP. La diferencia está en qué responde cada uno.

	Verificación de empleo	Semanas cotizadas	Consulta de NSS
La pregunta que responde	¿Trabaja hoy y con quién?	¿Cuál ha sido su trayectoria laboral?	¿Cuál es su Número de Seguridad Social?
Qué mandas	La CURP. El NSS es opcional: si lo envías, se coteja.	La CURP.	La CURP.
Qué recibes	Si tiene empleo vigente, el patrón con su RFC y registro patronal, el salario base de cotización y los días cotizados del periodo.	Las semanas cotizadas, el historial completo de empleos y señales calculadas de antigüedad, estabilidad y salario, cada una con su fórmula.	El NSS de 11 dígitos, o el motivo exacto si no existe.
Documento oficial	El reporte del IMSS en PDF, si lo pides.	La constancia en PDF, con folio y sello digital. Siempre.	No aplica.
Costo por consulta resuelta	2 créditos	3 créditos	2 créditos
Úsalo cuando	Necesitas confirmar el empleo y el ingreso actual.	Necesitas evaluar estabilidad e ingreso a lo largo del tiempo.	Vas a dar de alta a alguien y no tienes su NSS.
	Ver verificación de empleo →	Ver semanas cotizadas →	Ver consulta de NSS →

Quién lo usa

Para decidir con el dato del patrón, no con lo declarado.

Crédito y fintechVerificar empleo e ingreso antes de aprobar, y medir estabilidad laboral para dimensionar línea y plazo.

◈

Nómina y recursos humanosDar de alta sin pedir la tarjeta del Seguro Social y confirmar la trayectoria que aparece en un currículum.

⚑

Arrendamiento y segurosComprobar que el solicitante tiene un empleo formal vigente y un ingreso consistente con lo que declaró.

Disponible hoy

No te pedimos que nos creas. Compruébalo.

Es común que un servicio del IMSS aparezca en un catálogo o en una documentación y no exista a la hora de integrar. Por eso, antes de hablar con nosotros, hay tres cosas que puedes revisar por tu cuenta.

El endpoint está publicadoCon su ruta, sus datos de entrada y su costo en créditos, en la referencia abierta del API. Sin registro.Ver el endpoint ↗

Cada respuesta tiene su ejemploTodos los casos que puede regresar, con el JSON completo de cada uno. No una descripción general: el contrato.Ver los ejemplos ↗

Lo pruebas con tus propios casosTe habilitamos créditos de cortesía en producción. Mandas tus CURP y ves qué regresa, antes de firmar nada.Solicitar acceso →

Cómo funciona

Envías la CURP. El resultado llega a tu sistema.

Las tres consultas funcionan igual: mandas la petición con una dirección tuya, llamada webhook, recibes un acuse de inmediato y el resultado llega a esa dirección en cuanto está listo.

{ }

Envías la CURPcon la dirección de tu webhook

Recibes un acusecon un folio de la consulta

✓

Llega el resultadoa tu webhook, con el mismo folio

¿Es la primera vez que usas un webhook? Te lo explicamos paso a paso →

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.

¿Qué se puede consultar del IMSS por API?

Tres cosas, las tres a partir de la CURP: si la persona tiene empleo vigente y con qué patrón; su Constancia de Semanas Cotizadas, con el historial laboral completo; y su Número de Seguridad Social.

¿Cuál es la diferencia entre verificación de empleo y semanas cotizadas?

La verificación de empleo responde por el presente: si trabaja hoy, con quién y con qué salario base de cotización. Semanas cotizadas responde por toda la trayectoria: cada empleo que ha tenido, con sus fechas y salarios, más señales calculadas de estabilidad.

¿Necesito el NSS para consultar?

No. Las tres consultas parten de la CURP. En la verificación de empleo el NSS es opcional: si lo envías, se coteja contra el que el IMSS tiene registrado.

¿Cómo recibo el resultado?

En tu webhook. Al crear la consulta recibes un acuse con un folio; cuando el resultado está listo lo enviamos a tu dirección con ese mismo folio.

¿Cuánto cuesta?

Verificación de empleo y consulta de NSS usan 2 créditos por consulta resuelta; semanas cotizadas usa 3. El acuse no se cobra. Los planes están publicados.

¿OrigoID es parte del IMSS?

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