Cómo saber por la API si la versión instalada está afectada por una CVE
Usa el campo affected_versions para decidir si la versión que tienes está en el rango vulnerable, y /changes con /cve/batch para mantener tu base al día sin descargar todo de nuevo.
Lo que necesitas
- La clave de la API: la guía de primeros pasos muestra cómo generarla.
- La lista de productos y versiones que quieres verificar.
Límites de la cuenta: gratis, 50 por día y 10 por minuto · SOC, 5000 por día y 60 por minuto · MSSP, 20.000 por día y 120 por minuto.
Paso a paso
Lee el affected_versions de la CVE
Cada ítem trae el fabricante, el producto, la base del rango (version), el límite superior exclusivo (less_than) o inclusivo (less_or_equal), el status y el version_type, que dice cómo comparar.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/cve/CVE-2024-3400" | jq '.data.affected_versions'
Compara como versión, no como texto
Usa un comparador que respete el version_type, como packaging.version de Python para semver. En orden alfabético, una versión menor puede parecer mayor; git y custom piden un tratamiento propio.
"2.4.9" > "2.4.49" # verdadeiro como texto, falso como versão
Respeta los límites y el status
less_than no incluye el límite y less_or_equal sí: equivocarse ahí falla justo en la versión de frontera. El rango con status unaffected es la CNA diciendo que no es vulnerable.
Trata el rango vacío como falta de dato
Sin affected_versions, la CNA no publicó la versión: la CVE afecta a la familia del producto, y tu versión no se puede confirmar. Muestra la laguna en lugar de concluir que no afecta.
Busca solo lo que cambió
/changes lista las CVE, los incidentes y las víctimas que cambiaron desde una fecha, de hasta 30 días atrás. Con truncated, repite la llamada con el next_since que vino en la respuesta.
curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \ "https://api.vexday.io/api/v1/changes?since=2026-11-01T00:00:00Z"
Trae el detalle en lote
/cve/batch devuelve varias CVE en una llamada. Cada ID cuenta una consulta en el límite diario, y los que no existen vuelven en not_found, sin error.
curl -s -X POST -H "Authorization: Bearer vx_live_SUA_CHAVE" -H "Content-Type: application/json" \ -d '{"ids": ["CVE-2024-3400", "CVE-2021-44228"]}' "https://api.vexday.io/api/v1/cve/batch"