GET /epss

The EPSS Data public information (see http://www.first.org/epss) is available for querying using the endpoint /epss:

Repository Endpoint URL Status
FIRST API v1 https://api.first.org/data/v1/epss BETA

Additional Parameters

These parameters may be added (in addition to the Global parameters) to the query string to filter the results:

Parameter Type Description
cve string Filters by EPSS CVE ID. Multiple values are supported separated by commas. The maximum size accepted for this parameter is 2000 characters (including commas).
date date Date in the format YYYY-MM-DD (since April 14, 2021), shows the historic values for epss and percentile attributes.
days int Number of days since the EPSS score was added to the database (starting at 1, not affected by the date parameter).
epss-gt decimal Only display CVEs with EPSS score greater or equal than the parameter.
percentile-gt decimal Only display CVEs with percentile greater or equal than the parameter.
epss-lt decimal Only display CVEs with EPSS score lower or equal than the parameter.
percentile-lt decimal Only display CVEs with percentile lower or equal than the parameter.
q string Free text search at the CVE ID (allows partial matches).

Scope

These are the allowed scope for the EPSS dataset:

Scope Description
public (default) Shows the basic EPSS data (cve, epss, percentile, created).
time-series Shows the last 30 days (or what is available) of the EPSS score and percentile for any CVE.

Response

The response object contains a list of matching CVEs and their EPSS scores:

curl -X GET "https://api.first.org/data/v1/epss?cve=CVE-2021-40438,CVE-2019-16759&date=2022-02-28&pretty=true"
{
    "status": "OK",
    "status-code": 200,
    "version": "1.0",
    "access": "private, no-cache",
    "total": 2,
    "offset": 0,
    "limit": 100,
    "data": [
        {
            "cve": "CVE-2021-40438",
            "epss": "0.972240000",
            "percentile": "1.000000000",
            "date": "2022-02-28"
        },
        {
            "cve": "CVE-2019-16759",
            "epss": "0.968170000",
            "percentile": "0.999990000",
            "date": "2022-02-28"
        }
    ]
}