search_cve_history
Retrieve change history for CVE records from the NVD, including event type, timestamp, and change details. Filter by date range, CVE ID, or event type to monitor vulnerability modifications.
Instructions
Search the NVD CVE Change History API for changes made to CVE records.
Returns a JSON string with pagination info and a list of change events, each containing the CVE ID, event type, source, timestamp, and change details.
Performance guidance — the history API is significantly slower than the CVE API:
Always set results_per_page to 2–5.
Narrow the date window to 7 days or less when using change_start_date / change_end_date. The maximum allowable range is 120 consecutive days.
Avoid querying by event_name alone without a date range — it scans the entire history database and will time out. Combine event_name with a date range.
For a specific CVE use cve_id; that is the fastest query.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request | Yes | NVD CVE History API 2.0 request model. The CVE Change History API is used to easily retrieve information on changes made to a single CVE or a collection of CVE from the NVD. This API provides additional transparency to the work of the NVD, allowing users to easily monitor when and why vulnerabilities change. The NVD has existed in some form since 1999 and the fidelity of this information has changed several times over the decades. Earlier records may not contain the level of detail available with more recent CVE records. This is most apparent on CVE records prior to 2015. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |