Cómo consultar el CURP con el NSS: Guía de integración para desarrolladores

Consultar el CURP con el NSS es posible mediante una API que vincula ambos identificadores en tiempo real, eliminando procesos manuales en portales gubernamentales. Esta guía explica cómo realizar la consulta programática, qué datos se obtienen y cómo integrarla en flujos de verificación de identidad, registro de empleados y cumplimiento AML/KYC. Si eres desarrollador o responsable de compliance en México, aquí encontrarás los pasos técnicos y las consideraciones regulatorias para implementar esta validación.

¿Cómo consultar el CURP con el NSS?

El NSS (Número de Seguridad Social) y el CURP (Clave Única de Registro de Población) están vinculados en la base de datos del IMSS. Una API de consulta NSS-CURP permite enviar un NSS y recibir el CURP asociado, junto con datos adicionales como nombre completo, fecha de nacimiento y vigencia del NSS. La respuesta se entrega en formato JSON firmada con un hash de verificación, lo que garantiza la integridad de los datos y cumple con requisitos de auditoría para instituciones reguladas.

Relación entre NSS y CURP

El IMSS asigna el NSS a partir del CURP, por lo que existe una correspondencia biunívoca. Mientras que el CURP es la clave de identidad a nivel nacional administrada por RENAPO, el NSS es el identificador del trabajador en el sistema de seguridad social. Ambos se utilizan en trámites como registro ante el IMSS, AFORE, créditos Infonavit y declaraciones fiscales.

¿Qué datos se pueden obtener a partir del NSS?

Al consultar un NSS válido, la API devuelve:

Además, se incluye un identificador único de transacción y un sello de tiempo para trazabilidad.

Ejemplo de flujo de consulta

1. El usuario proporciona su NSS durante un proceso de onboarding.
2. Tu sistema envía una solicitud POST a la API de NSS con el número.
3. La API valida contra la base del IMSS y devuelve el CURP y datos asociados.
4. Tu aplicación cruza esos datos con los ingresados por el usuario para verificar identidad.
5. El resultado se almacena junto con el hash de verificación para futuras auditorías.

Para detalles técnicos específicos, consulta la documentación oficial de la API de NSS.

¿Qué es el NSS y cómo se relaciona con el CURP?

El NSS es un número único de 11 dígitos asignado por el IMSS a cada trabajador registrado en el régimen obligatorio de seguridad social. Se utiliza para cotizar, acceder a servicios médicos, pensiones y prestaciones. El CURP, por su parte, es la clave alfanumérica de 18 caracteres que identifica a toda persona física en México, emitida por RENAPO.

La vinculación oficial se establece en el momento del registro patronal: el empleador proporciona el CURP del trabajador, y el IMSS asigna el NSS correspondiente. Por ello, toda consulta válida de NSS debe devolver el CURP asociado, y viceversa. Esta relación se utiliza en procesos de verificación laboral, afiliación a AFORE y solicitudes de crédito Infonavit.

Definición del NSS

El NSS (Número de Seguridad Social) es el identificador del trabajador en el IMSS. Se compone de la clave de la subdelegación, el año de inscripción y un número consecutivo. Es obligatorio para cualquier persona que trabaje bajo relación laboral en México.

Definición del CURP

La CURP es la clave de identidad oficial a nivel nacional, asignada por la Secretaría de Gobernación a través de RENAPO. Se basa en datos biométricos y demográficos de la persona, como nombre, fecha de nacimiento y lugar de origen.

Vinculación oficial entre ambos identificadores

El IMSS y RENAPO mantienen bases de datos interconectadas. Cualquier NSS activo debe tener un CURP asociado. Esta vinculación es utilizada por empleadores y entidades financieras para validar la identidad de los trabajadores.

Validación del NSS con CURP: casos de uso prácticos

La validación cruzada NSS-CURP tiene aplicaciones concretas en varios sectores.

Verificación laboral y registro en el IMSS

Las empresas de staffing y recursos humanos necesitan confirmar que un empleado está registrado correctamente ante el IMSS. Al consultar el NSS con el CURP, se verifica que el número de seguridad social corresponda a la persona, evitando errores de captura o fraudes. Esto es especialmente útil cuando el empleado no recuerda su NSS; se puede obtener a partir de su CURP mediante una API como la que ofrece API Pull para consultar NSS por CURP.

Onboarding de empleados en fintechs y seguros

En fintechs de microcréditos o seguros, es común solicitar el CURP durante el registro. Si el usuario también proporciona su NSS, la validación cruzada permite confirmar su relación laboral y su historial de cotización. Esto es clave para productos como préstamos con descuento vía nómina o seguros de vida laboral.

Cumplimiento AML/KYC en instituciones financieras

Las instituciones reguladas por la CNBV deben implementar medidas de KYC (Conoce a tu Cliente) y AML (Anti-Lavado de Dinero). La validación NSS-CURP ayuda a detectar identidades sintéticas o datos inconsistentes. Además, la respuesta firmada de la API proporciona evidencia de auditoría, como se describe en la CURP Compliance API.

Integración técnica de la API de NSS de API Pull

¿Qué se envía y qué se recibe?

Conceptualmente, envías una solicitud HTTP con el NSS (o CURP) y recibes un objeto JSON con los datos asociados y un hash de verificación. La API no expone documentación interna aquí; para conocer los parámetros exactos, consulta la documentación oficial.

Autenticación y seguridad

La autenticación se realiza mediante una API key que se incluye en el encabezado de la solicitud. Cada respuesta incluye un identificador único de transacción y una marca de tiempo, garantizando la trazabilidad. El hash de verificación permite comprobar que los datos no han sido alterados desde su recepción.

Entorno sandbox y pruebas

API Pull proporciona un entorno sandbox con casos sintéticos para que puedas probar la integración sin afectar datos reales. Esto es fundamental para validar el flujo antes de pasar a producción.

Procesamiento por lotes y webhooks

Para operaciones de alto volumen, la API soporta endpoints de lote (batch) donde puedes enviar hasta 100 CURPs o NSS en una sola solicitud. También ofrece webhooks para procesamiento asíncrono, ideal para sistemas que necesitan respuestas sin bloquear el flujo principal.

Cuándo esta herramienta no es la adecuada

Limitaciones de la consulta NSS-CURP

La API solo confirma la relación entre el NSS y el CURP y devuelve datos básicos. No proporciona documentos como acta de nacimiento, comprobante de domicilio ni historial completo de cotizaciones. Si necesitas verificar la identidad de una persona con INE, pasaporte o biometría, deberás combinar esta API con otros servicios.

Alternativas para casos más complejos

Para obtener el historial de semanas cotizadas en el IMSS, se requiere un servicio diferente (consulta de semanas). Si tu objetivo es validar la situación fiscal de un RFC, necesitarás la RFC API. Para verificar listas negras, la AML API es la herramienta adecuada. API Pull ofrece un ecosistema de APIs que cubren estos casos.

Alternativas y complementos: CURP API, RFC API y AML API

CURP API: validación en tiempo real contra RENAPO

La CURP API de API Pull valida la clave contra la base de RENAPO, devolviendo datos demográficos completos. Es útil para verificar la identidad de personas que no tienen NSS o que no están registradas en el IMSS. Puedes conocer más en la CURP API.

RFC API: verificación de situación fiscal

La RFC API permite consultar el Registro Federal de Contribuyentes para saber si una persona o empresa está activa, su régimen fiscal y si tiene obligaciones pendientes. Es esencial para cumplir con la Ley del SAT.

AML API: listas negras y PEPs

La AML API de API Pull realiza búsquedas en la lista SAT 69-B, listas OFAC, la lista consolidada de la ONU y bases de PEPs mexicanas. Esto es obligatorio para instituciones financieras según la Ley Antilavado.

Todas estas APIs se pueden integrar a través del API Hub de API Pull, que simplifica la gestión de múltiples proveedores de datos.

Conclusión y próximos pasos

Consultar el CURP con el NSS de forma automatizada es posible mediante una API confiable. Esta validación agiliza procesos de onboarding, reduce errores manuales y fortalece el cumplimiento normativo. Si deseas probar la integración, te invitamos a explorar el sandbox de API Pull sin costo. La documentación oficial contiene ejemplos de código y guías paso a paso. El equipo de soporte técnico está disponible para resolver cualquier duda durante la implementación.

No esperes a que un empleado olvide su NSS: automatiza la consulta con una API y mejora la experiencia de tu usuario.