Premium EPSS Series

1 credit

GET /api/premium/security/epss/series

Full historical EPSS time-series for one CVE from FIRST.org. Daily probability + percentile points back to the CVE's first EPSS publication date.

When to use this endpoint

When tracking how exploitation likelihood changed over time for a specific CVE. Useful for post-incident reviews ("did EPSS predict this?") and patch-priority trending.

Parameters

Name	In	Type	Description
cve_id*	query	string	CVE identifier`e.g. CVE-2024-3094`

* required

Example response

{ "ok": true, "cve_id": "CVE-2024-3094", "series": [ { "date": "2024-04-01", "epss": 0.05, "percentile": 0.85 }, { "date": "2026-05-08", "epss": 0.85, "percentile": 0.99 } ], "count": 401, "billing": { "credits_charged": 1, "credits_remaining": 49 } }

Code samples

Python SDK

tf._get("/premium/security/epss/series", cve_id="CVE-2024-3094")

TypeScript SDK

await fetch("https://tensorfeed.ai/api/premium/security/epss/series?cve_id=CVE-2024-3094", { headers: { Authorization: "Bearer tf_live_..." } });

FAQ

How far back does EPSS go?

FIRST.org backfilled to early 2021 for older CVEs. Newer CVEs start the day they enter EPSS.

Related endpoints

Premium EPSS Top-N

/api/premium/security/epss/top

Premium Verified CVE (cross-database)

/api/premium/security/verified/{cve_id}

OpenAPI 3.1 spec ·Agent payments docs·For AI agents