🏥 Servicio de Vigencia de Derechos del IMSS

• Método: POST
• URL de Consumo: https://consultaunica.mx/api/v2/imss?_v=2
• Compra de paquetes: https://bit.ly/cu-srv-imss (opens new window)

Headers (solo en caso de tener API Key)

{
    "X-API-KEY": "1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f1a2b3c4d5e6f"
}

Payload JSON de ejemplo (obligatorios)

{
    "type": "vd",
    "vdSc": {
        "curp": "LOOA531113HTCPBN07",
        "nss": "1234567890"
    },
    "userEmail": "amlo@gmail.com"
}

Respuesta exitosa. HTTP 200

{
    "message": "La vigencia de derechos ha sido enviada al correo capturado"
}

⚠ No se encontró el teléfono. HTTP 204

// vacio

❌ Error de CURP. HTTP 400

La CURP tiene un formato inválido

{
    "message": "{'vdSc': {'curp': ['CURP does not match expected pattern']}}"
}

El NSS debe tener 11 dígitos

{
    "message": "{'vdSc': {'nss': ['Length must be 11.']}}"
}

El correo tiene un formato inválido

{
    "message": "{'userEmail': ['Not a valid email address.']}"
}

❌ Solo se puede consumir la vigencia de derechos 2 veces por día. HTTP 500

El IMSS así lo limita para cada consulta de la misma CURP y NSS.

{
    "message": "Solo puede consultar 2 veces al día su vigencia de derechos
"
}

❌ Error desconocido. HTTP 500

{
    "message": "Mensaje describiendo el error"
}