🏥 Alterno. Servicio de consulta de reportes de NSS del IMSS

• Método: POST
• URL de Consumo: https://consultaunica.mx/api/v3/imss
• Compra de paquetes: https://consultaunica.mx/#prices (opens new window)

Headers (requerido API Key)

{
    "x-api-key": "1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f"
}

Payload JSON de ejemplo (obligatorios)

// POST https://consultaunica.mx/api/v3/imss
{
    "type": "lmxi_nss",
    "lmxiNss": {
        "curp": "LOOA531113HTCPBN07",
        "userEmail": "amlo@gmail.com"
    }
}

✅ Respuesta exitosa. HTTP 200

{
    "variant": "lmxi_nss",
    "lmxiNss": {
        "message": "Constancia de NSS enviada al correo ingresado",
        "nss": "01806151484",
        "curp": "LOOA531113HTCPBN07",
        "rfc": "LOOA531113XYZ",
        "name": "ANDRES MANUEL",
        "paternalName": "LOPEZ",
        "maternalName": "OBRADOR",
        "birthDate": "1953-11-13",
        "sex": "Hombre",
        "email": "",
        "pdfUrlCard": "https://consultaunica.mx/static/pdf/imss/Tarjeta%20-%20LOOA531113HTCPBN07.pdf",
        "pdfUrlVoucher": "https://consultaunica.mx/static/pdf/imss/Comprobante%20-%20LOOA531113HTCPBN07.pdf"
    }
}

❌ Error de validación de datos. HTTP 409

La CURP tiene un formato inválido

{
    "message": "La consulta no es válida, favor de verificar los datos ingresados",
    "errors": [
        {
            "field": "body.lmxiNss.curp",
            "error": "String should match pattern '^[A-Z][AEIOUX][A-Z]{2}[0-9]{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])[MHX]([ABCMTZ]S|[BCJMOT]C|[CNPST]L|[GNQ]T|[GQS]R|C[MH]|[MY]N|[DH]G|NE|VZ|DF|SP)[BCDFGHJ-NP-TV-Z]{3}[0-9A-Z][0-9]$'"
        }
    ]
}

El correo tiene un formato inválido

{
    "message": "La consulta no es válida, favor de verificar los datos ingresados",
    "errors": [
        {
            "field": "body.lmxiNss.userEmail",
            "error": "value is not a valid email address: An email address must have an @-sign."
        }
    ]
}

❌ Error del IMSS. HTTP 400

{
    "message": "La persona no cuenta con NSS"
}

Otros mensajes de error pueden ser:

• "El NSS solo puede consultarse 2 veces al día"
• "El correo ya fue usado con otra CURP, escriba un correo diferente"
• "No se localizó información en RENAPO con la CURP capturada"
• "Es necesario ir a una subdelegación para recibir el reporte"

❌ Error desconocido. HTTP 500

{
    "message": "Algo falló durante la consulta, favor de consultar nuevamente"
}

Otros mensajes de error pueden ser:

• "El servicio de consulta de NSS alterno no está disponible, favor de intentar más tarde"