# EPSS History

GET /explore/vulnerability-insight/epss-history/{cve}: Returns the EPSS (exploit prediction) score history of a CVE.

Source: https://docs.deepinfo.com/reference/vulnerability/epss-history/

Last updated: 2026-09-27

---
`GET https://api.deepinfo.com/v1/explore/vulnerability-insight/epss-history/{cve}`

Returns the EPSS (exploit prediction) score history of a CVE.

## Authentication

Send your API key in the `apikey` request header.

## Path Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `cve` | Required |  | `CVE-2021-44228` |

## Response Fields

| Field | Type |
|---|---|
| `cve` | string |
| `records` | array of object |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

| Field | Type |
|---|---|
| `cve` | string |
| `records` | array<object> |
| `records[].epss` | number |
| `records[].percentile` | number |
| `records[].date` | string |

## Examples

### 200 · OK

```bash
curl 'https://api.deepinfo.com/v1/explore/vulnerability-insight/epss-history/CVE-2021-44228' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "cve": "CVE-2021-44228",
  "records": [
    {
      "epss": 0.99999,
      "percentile": 1.0,
      "date": "2026-09-21"
    },
    {
      "epss": 0.99999,
      "percentile": 1.0,
      "date": "2026-09-20"
    }
  ]
}
```

### 400 · Validation Error (unknown cve)

```bash
curl 'https://api.deepinfo.com/v1/explore/vulnerability-insight/epss-history/not-a-real-value-zzz' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "code": 10400,
  "parameters": [
    {
      "param": "cve",
      "details": [
        "The given input is not a valid cve."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```

## Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and its response: [EPSS History Examples](/reference/vulnerability/epss-history/examples/).

- [Log4Shell (CVE-2021-44228)](/reference/vulnerability/epss-history/examples/cve-2021-44228/): The EPSS history of Log4Shell, 0.99999 with percentile 1.0 on every day shown, the top of the scale.
- [A CVE in the CISA KEV Catalog (CVE-2026-86218)](/reference/vulnerability/epss-history/examples/cve-2026-86218/): The whole EPSS history of a 2026 CVE in the CISA KEV catalog, which rose in two steps from 0.00411 to 0.07494.