Epss Get Timeseries
epss_get_timeseriesRetrieve an EPSS anchor and up to 30 preceding daily observations for up to 50 unique CVEs from batchOffset. Response byte limits retain whole history items. Resume CVE batches with nextBatchOffset as batchOffset, the original cves and returned score date as date; withheldCves were processed, deferredCves were not queried, and lists can be declared previews. Exact 7-day and 30-day deltas require their calendar baselines; gaps remain unknown. Model boundaries do not explain score movement. Re-anchor using previousAnchorDate for the preceding history window; that snapshot may be unavailable.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cves": "<cves>"
},
"name": "epss_get_timeseries"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cves | Yes | One to 5000 CVE identifiers; whitespace, comma or semicolon-delimited strings are also accepted. | |
| date | No | UTC date YYYY-MM-DD from 2021-04-14 through today; omitted or blank selects latest available data. | |
| batchOffset | No | Resume in first-occurrence normalized unique input order; resubmit the original cves, returned score date and original policy/severity inputs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| items | No | Derived trajectories ordered by anchor EPSS descending then CVE. | |
| notice | No | Missing-data, deferred-work or model-metadata caveats. | |
| provenance | No | Source and model attribution. | |
| batchOffset | No | Starting offset in the original normalized unique input. | |
| deferredCves | No | Never-queried identifiers beyond this call workload cap; complete unless deferredCvesComplete is false. Resume using nextBatchOffset and the original submission. | |
| unscoredCves | No | Retained processed identifiers without scores, in request order. | |
| withheldCves | No | Already processed identifiers withheld by the byte budget, in original input order; may be a preview. | |
| budgetLimited | No | True when whole entries or accounting lists were shortened to fit the serialized response budget. | |
| deferredCount | No | Identifiers beyond this call workload cap, not queried. | |
| returnedCount | No | Processed identifiers whose complete score, history or unscored entry is included. | |
| withheldCount | No | Processed identifiers withheld by the response byte budget; queried valid entries are included in processedCount. | |
| duplicateCount | No | Duplicate submitted entries removed. | |
| processedCount | No | Unique identifiers processed, including invalid formats. | |
| requestedCount | No | Unique normalized identifiers submitted. | |
| nextBatchOffset | No | Resume with this batchOffset and the original cves, returned date and original severity/policy inputs. | |
| deferredCvesComplete | No | True when deferredCves includes every never-queried deferred identifier. | |
| withheldCvesComplete | No | True when withheldCves includes every withheld identifier. |