🏥 Servicio de enviar al correo Vigencia de Derechos del Seguro Social

Hay tres consultas de vigencia de derechos. Esta entrega el documento al titular, no a ti.

Consulta	Qué obtienes	Entrada	Forma
Esta página	El Seguro Social envía la constancia al correo del titular. Tú no recibes el archivo.	curp + nss + userEmail	Síncrona
Solo validar vigencia	Un JSON que dice si la persona tiene servicio médico vigente. Sin documento.	curp + nss	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?_v=2
• Compra de paquetes: https://consultaunica.mx/paquetes

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

Ejemplo de consumo

curl -X POST 'https://api.consultaunica.mx/v3/imss?_v=2' \
  -H 'x-api-key: 1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "vd",
    "vdSc": {
      "curp": "LOOA531113HTCPBN07",
      "nss": "12345678901"
    },
    "userEmail": "[email protected]",
    "allowEmailConcat": true // default: true; concat nss to email, example: [email protected]
  }'

✅ Respuesta exitosa. HTTP 200

{
    "message": "Reporte de vigencia de derechos enviado al correo ingresado"
}

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"
        }
    ]
}

El correo 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.userEmail",
            "error": "value is not a valid email address: An email address must have an @-sign."
        }
    ]
}

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

{
    "message": "El NSS no fue localizado en el Seguro Social"
}

Otros mensajes de error pueden ser:

• "El correo ya fue usado con otra CURP, escriba un correo diferente"
• "La vigencia de derechos solo puede consultarse 2 veces al día"

❌ Errores de consulta con el Seguro Social. HTTP 422

{
    "message": "No se localizó información en RENAPO con la CURP capturada"
}

Otros mensajes de error pueden ser:

• "El servicio de RENAPO tienen inconsistencias con la CURP"

❌ Error desconocido. HTTP 500

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