# NVD API with KEV and EPSS: how to triage a CVE

Use the NVD API with CISA KEV and EPSS to triage a CVE: CVSS score, exploited status and exploit odds, plus NVD API key rate limits.

## Summary

The NVD API gives you a CVSS score, and a CVSS score tells you how bad a vulnerability could be. It does not tell you whether anyone is exploiting it. To triage a CVE from code, you want the NVD record plus two more signals: whether the flaw is on the CISA Known Exploited Vulnerabilities list, and what its EPSS score says about the chance of exploitation. Those signals come from three public sources with three different APIs, which is why many teams end up sorting by severity alone.

This guide runs all three on Log4Shell (CVE-2021-44228), shows the answers, and covers the NVD API key and its rate limits. By the end you can write your own triage function, or hand the job to your agent with the prompt below. looot serves the three sources through one key and one request shape.

## What does each source answer?

Each source answers a different question, which is why they work better together than any one does alone. NVD describes the flaw and how severe it could be. KEV records that exploitation has actually been seen. EPSS forecasts how likely exploitation is in the next 30 days.

| Source | Question | Log4Shell, 2026-11-16 | looot endpoint |
|---|---|---|---|
| NVD CVE API | What is it, and how severe? | CVSS 3.1 base score 10.0 | `nvd-cve-get` |
| CISA KEV catalog | Is it known to be exploited? | Listed, added 2021-12-10 | `cisa-kev-catalog` |
| FIRST EPSS API | How likely is exploitation? | 0.99999, percentile 1.0, score date 2026-11-15 | `first-epss-score` |

CISA publishes KEV as one file in [JSON](https://www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json) and CSV. Version 2026.11.13, released on 2026-11-13, holds 1,781 entries.

## How do you get a CVE record from the NVD API?

Send a GET request to the CVE API 2.0 with `cveId`, and you get back the description, CVSS scores, weaknesses and affected configurations. The record also carries the KEV fields when the CVE is on that list, so this one call often answers two of the three questions. Without a key, the request needs nothing else:

Through looot, the same lookup is a run of `nvd-cve-get`:

Here are the fields from that answer that matter for triage, trimmed from the full record:

When `cisaExploitAdd` is missing, the CVE is not on the KEV list. A CVE the NVD does not have comes back as a miss, which you should record and not retry. A miss is free.

## Do you need an NVD API key?

You need one only when you send more than a few requests. The NVD's [Start Here page](https://nvd.nist.gov/developers/start-here) sets the public rate limit at 5 requests in a rolling 30 second window, and 50 requests in the same window with an API key. Even with a key, the NVD recommends that your script sleep for six seconds between requests.

|  | Without a key | With a key |
|---|---|---|
| Requests per rolling 30 seconds | 5 | 50 |
| Where the key goes | none | request header `apiKey` |
| Pause the NVD recommends | six seconds between requests | six seconds between requests |

To get a key, fill in the form on the [Request an API Key page](https://nvd.nist.gov/developers/request-an-api-key) with a valid email address. The NVD emails you a link, and you must activate the key within seven days or request a new one. A key belongs to one requestor, and activating a new key turns off the old one. The 2.0 APIs take the key in the request header:

To keep a full local copy, page through the CVE API with a key and that pause, then refresh no more than once every two hours with a last-modified window, as the Start Here page describes.

## How do you check the exploit probability?

Run `first-epss-score` with the same id, or call `https://api.first.org/data/v1/epss?cve=CVE-2021-44228` directly. [EPSS](https://www.first.org/epss/) answers with the probability, from 0 to 1, that the CVE is exploited in the wild in the next 30 days, along with its percentile among all scored CVEs and the date of the score.

If you have a whole list of CVEs, `first-epss-scores` takes up to 50 in one call, and `first-epss-top` returns the highest scored. When your starting point is a package and not a CVE, `osv-package-advisories` returns its open-source advisories.

## How would you triage a CVE with these signals?

Start with KEV, because exploitation that has already been seen outweighs any forecast, so those flaws get fixed first. High EPSS scores come next, since those are likely to be exploited soon, while a high CVSS score with a low EPSS score can usually be scheduled. This order is our suggestion and not a standard, so set thresholds that fit your own systems.

Log4Shell scores at the top of all three, which makes it an easy demo and a poor test. The approach earns its keep on your own backlog, where the signals disagree.

To run it on one CVE, paste this into your agent:

The [nvd-cve-get catalog page](https://looot.ai/public-catalog/nvd-cve-get) lists its inputs and current price, and the [FIRST EPSS provider page](https://looot.ai/providers/first-epss) lists the three EPSS endpoints. For jobs that have several providers, read [how data provider fallback works](https://looot.ai/blog/automatic-provider-fallback-for-data-apis), and for paid sources see [what your agent's data calls cost](https://looot.ai/blog/ai-agent-cost-data-calls).

## What it cannot do

This does not scan your systems, so you bring the CVE ids or package names yourself. It does not merge the three answers into one record either: your code makes the calls and combines them. The record comes straight from NVD, so if NVD is down the call fails and you try again later.

looot sends NVD calls without an NVD key, so they share the public limit. For a bulk pull of thousands of records, request your own key and call the NVD directly with the pause it recommends. Watching for new CVEs on a timer needs scheduled runs, not available yet; until then, call `nvd-cve-search` from your own scheduler. If you want either of these, ask your agent to send the request to looot as feedback.

This product uses data from the NVD API but is not endorsed or certified by the NVD. See EPSS at [https://www.first.org/epss](https://www.first.org/epss).

## Questions

### What is the NVD API?

It is the National Vulnerability Database's public REST API. The CVE API 2.0 returns vulnerability records by CVE id or by search, with descriptions, CVSS scores and affected configurations.

### What are the NVD API rate limits?

Without a key, 5 requests in a rolling 30 second window. With an API key, 50 requests in the same window. The NVD still recommends a six second pause between requests.

### How do I get an NVD API key?

Request one on the NVD's Request an API Key page with a valid email address, then activate it from the emailed link within seven days. Send it in the `apiKey` request header.

### What is the difference between CVSS, KEV and EPSS?

CVSS rates how severe a flaw could be. KEV lists flaws known to be exploited. EPSS estimates how likely exploitation is in the next 30 days. For Log4Shell on 2026-11-16 they read 10.0, listed and 0.99999.

### How do I check if a CVE is known to be exploited?

Look up the CVE in the NVD API and read `cisaExploitAdd`, or pull the whole list with `cisa-kev-catalog`. The field is absent when the CVE is not on the KEV list.

### Does the NVD API cost money through looot?

No. The [public catalog](/public-catalog) shows the current price per call of each endpoint. Ask your agent to inspect the endpoint before a large batch.

### Can it tell me when a new CVE appears?

No. Alerts need scheduled runs, not available yet. You can call `nvd-cve-search` with a last-modified window from your own scheduler.

### Should I call the NVD API directly?

If you only need NVD, yes, it is a public API, and with your own key you get the higher rate limit. One looot key helps when you want NVD, KEV and EPSS in one request shape with run history.

## For agents

### Code (bash)

```bash
curl -s "https://services.nvd.nist.gov/rest/json/cves/2.0?cveId=CVE-2021-44228"
```

### Code (bash)

```bash
curl -s -X POST "https://api.looot.ai/v1/runs?wait=20" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "content-type: application/json" \
  -d '{"endpointId":"nvd-cve-get",
       "input":{"cve_id":"CVE-2021-44228"},
       "idempotencyKey":"triage-CVE-2021-44228-nvd"}'
```

### Code (json)

```json
{"vulnerabilities":[{"cve":{"id":"CVE-2021-44228",
  "cisaExploitAdd":"2021-12-10",
  "metrics":{"cvssMetricV31":[{"cvssData":{"baseScore":10.0}}]}}}]}
```

### Code (bash)

```bash
curl -s -H "apiKey: $NVD_API_KEY" \
  "https://services.nvd.nist.gov/rest/json/cves/2.0?cveId=CVE-2021-44228"
```

### Code (json)

```json
{"data":[{"cve":"CVE-2021-44228","epss":"0.999990000",
  "percentile":"1.000000000","date":"2026-11-15"}]}
```

### Triage one CVE

```text
Use looot to triage a CVE.
1. Set up https://looot.ai/skill.md.
2. For the CVE I give you, run nvd-cve-get and first-epss-score. Read the KEV fields from the NVD record.
3. Show the CVSS base score, whether it is on KEV with the date added, the EPSS score and its date, and the cost of each run.
4. Say which signal drives your suggested priority. If a run is a miss, say so.
```
