🏥 Servicio de solo validación de Vigencia de Derechos del Seguro Social

Hay tres consultas de vigencia de derechos. Esta es la que no entrega documento.

Consulta	Qué obtienes	Entrada	Forma
Esta página	Un JSON que dice si la persona tiene servicio médico vigente. Sin documento.	curp + nss	Síncrona
Vigencia al correo	El Seguro Social envía la constancia al correo del titular. Tú no recibes el archivo.	curp + nss + userEmail	Síncrona
Vigencia premium	La constancia en PDF, entregada a tu sistema.	curp	Asíncrona

• Método: POST
• URL de Consumo: https://api.consultaunica.mx/v3/imss
• Compra de paquetes: https://consultaunica.mx/paquetes

🧪 ¿Todavía sin créditos? Prueba este servicio en POST /v3/mock/imss, con el mismo contrato y sin cargo. Ver ambiente de pruebas.

Ejemplo de consumo

curl -X POST https://api.consultaunica.mx/v3/imss \
  -H 'x-api-key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "vd_validity",
    "vdSc": {
      "curp": "LOOA531113HTCPBN07",
      "nss": "12345678901"
    }
  }'

✅ Respuesta exitosa. HTTP 200

{
    "variant": "vd_validity",
    "vdValidity": {
        "message": "La vigencia de derechos fue validada",
        "hasIncludedRight": true,
        "hasMedicalInsuranceRight": true,
        "validUntilDate": null
    }
}

Si además incluyes userEmail en la petición, el Seguro Social envía el reporte a ese correo y el message cambia a "La vigencia de derechos fue validada y enviada al correo ingresado"; el resto de la respuesta es idéntico.

Toda respuesta de error trae también description y errorCode

Los ejemplos que muestran solo message los omiten; revisa la estructura de las respuestas de error.

❌ Error de validación de datos. HTTP 409

La CURP tiene un formato inválido

{
    "message": "Datos inválidos, favor de verificar la información ingresada",
    "description": "Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.",
    "errorCode": "bad_request",
    "errors": [
        {
            "field": "body.vdSc.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 NSS debe tener 11 dígitos

{
    "message": "Datos inválidos, favor de verificar la información ingresada",
    "description": "Alguno de los datos que enviaste tiene un formato incorrecto o falta información obligatoria.",
    "errorCode": "bad_request",
    "errors": [
        {
            "field": "body.vdSc.nss",
            "error": "String should have at most 11 characters"
        }
    ]
}

❌ Error de datos reportados por el Seguro Social. HTTP 400

{
    "message": "No se encontró un registro asociado a la CURP ni al NSS proporcionado"
}

❌ Error desconocido. HTTP 500

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