Skip to main content

Get time series

Action ID: tools.first_epss.get_time_series Get an EPSS time series. Calls GET /data/v1/epss directly with scope=time-series for one CVE. Reference: https://api.first.org/epss/

Input fields

string
required
Filters by EPSS CVE ID. Multiple values are supported separated by commas. The maximum size accepted for this parameter is 2000 characters (including commas).
string | null
Base URL of the FIRST API.Default: null.
string | null
Date in the format YYYY-MM-DD (since April 14, 2021), shows the historic values for epss and percentile attributes.Default: null.

Lookup CVE scores

Action ID: tools.first_epss.lookup_cve_scores Look up CVE scores. Calls GET /data/v1/epss directly for one or more CVE identifiers. Reference: https://api.first.org/epss/

Input fields

string
required
Filters by EPSS CVE ID. Multiple values are supported separated by commas. The maximum size accepted for this parameter is 2000 characters (including commas).
string | null
Base URL of the FIRST API.Default: null.
string | null
Date in the format YYYY-MM-DD (since April 14, 2021), shows the historic values for epss and percentile attributes.Default: null.
integer | null
Limits the maximun number of records to be shown. Should be an integer number between 0 and 10,000.Default: null.
integer | null
Offsets the list of records by this number. The first item is 0.Default: null.

Search scores

Action ID: tools.first_epss.search_scores Search EPSS scores. Calls GET /data/v1/epss directly with FIRST API-native filters. Reference: https://api.first.org/epss/

Input fields

string | null
Base URL of the FIRST API.Default: null.
string | null
Date in the format YYYY-MM-DD (since April 14, 2021), shows the historic values for epss and percentile attributes.Default: null.
integer | null
Number of days since the EPSS score was added to the database (starting at 1, not affected by the date parameter).Default: null.
number | null
Only display CVEs with EPSS score greater or equal than the parameter.Default: null.
number | null
Only display CVEs with EPSS score lower or equal than the parameter.Default: null.
integer | null
Limits the maximun number of records to be shown. Should be an integer number between 0 and 10,000.Default: null.
integer | null
Offsets the list of records by this number. The first item is 0.Default: null.
number | null
Only display CVEs with percentile greater or equal than the parameter.Default: null.
number | null
Only display CVEs with percentile lower or equal than the parameter.Default: null.
string | null
Free text search at the CVE ID (allows partial matches).Default: null.