EPSS

The latest EPSS score and its full daily history.

GET/api/v1/cves/{cveId}/epss

The latest EPSS observation for the CVE, with the full daily time-series available on demand. EPSS (Exploit Prediction Scoring System) estimates the probability of exploitation activity in the next 30 days; FIRST republishes model output daily.

Parameters

Name	In	Type	Description
`cveId`	path	string	CVE identifier.
`history`	query	boolean	Include the daily time-series, oldest first. Default: `false`.
`days`	query	integer	With history=true, restrict the series to the trailing N days (1–3650).

Example request

curl "https://radicalnotion.ai/api/v1/cves/CVE-2025-55182/epss?history=true&days=30" \
  -H "Authorization: Bearer $RN_TOKEN"

Example response(history trimmed for brevity)

{
  "cve_id": "CVE-2025-55182",
  "current": {
    "date": "2026-07-22",
    "epss_score": 0.99562,
    "percentile": 0.99942,
    "model_version": "v2026.06.15"
  },
  "history": [
    {
      "date": "2026-07-14",
      "epss_score": 0.99562,
      "percentile": 0.99942
    },
    {
      "date": "2026-07-15",
      "epss_score": 0.99562,
      "percentile": 0.99942
    },
    {
      "date": "2026-07-22",
      "epss_score": 0.99562,
      "percentile": 0.99942
    }
  ]
}

Response schema

Field	Type	Description
`current`	object \| null	Latest observation: date, epss_score, percentile, model_version.
`history[]`	object[]	Present with history=true: {date, epss_score, percentile} per day, ascending.

Responses

Status	Meaning
`200`	Success.
`400`	A path or query parameter failed validation.
`401`	Missing or invalid access token.
`403`	The CVE is outside your access tier.
`404`	No record exists for the CVE.
`429`	Rate limit exceeded.

A CVE with no EPSS observation returns a null current score.

Empty result (200)

{
  "cve_id": "CVE-2025-55182",
  "current": null
}