# Severity by Year Stats

GET /explore/vulnerability-insight/vulnerability-severity-stats-by-year: CVE counts per severity and year.

Source: https://docs.deepinfo.com/reference/vulnerability/severity-by-year-stats/

Last updated: 2026-09-27

---
`GET https://api.deepinfo.com/v1/explore/vulnerability-insight/vulnerability-severity-stats-by-year`

CVE counts per severity and year.

## Authentication

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

## Query Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `vendor` | Optional |  |  |
| `product` | Optional |  |  |
| `version` | Optional |  |  |
| `version__startswith` | Optional |  |  |

## Response Fields

| Field | Type |
|---|---|
| `vendor` | string |
| `product` | string |
| `version` | string |
| `cve_count` | integer |
| `cve_count_by_year` | 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 |
|---|---|
| `vendor` | string |
| `product` | string |
| `version` | string |
| `cve_count` | number |
| `cve_count_by_year` | array<object> |
| `cve_count_by_year[].year` | number |
| `cve_count_by_year[].cve_count` | number |
| `cve_count_by_year[].cve_count_by_severity` | object |
| `cve_count_by_year[].cve_count_by_severity.critical` | number |
| `cve_count_by_year[].cve_count_by_severity.high` | number |
| `cve_count_by_year[].cve_count_by_severity.medium` | number |
| `cve_count_by_year[].cve_count_by_severity.low` | number |
| `cve_count_by_year[].cve_count_by_severity.other` | number |

## Examples

### 200 · OK

```bash
curl 'https://api.deepinfo.com/v1/explore/vulnerability-insight/vulnerability-severity-stats-by-year' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

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

```json
{
  "vendor": "",
  "product": "",
  "version": "",
  "cve_count": 395222,
  "cve_count_by_year": [
    {
      "year": 1988,
      "cve_count": 2,
      "cve_count_by_severity": {
        "critical": 0,
        "high": 2,
        "medium": 0,
        "low": 0,
        "other": 0
      }
    },
    {
      "year": 1989,
      "cve_count": 3,
      "cve_count_by_severity": {
        "critical": 0,
        "high": 2,
        "medium": 1,
        "low": 0,
        "other": 0
      }
    }
  ]
}
```

## Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and its response: [Severity by Year Stats Examples](/reference/vulnerability/severity-by-year-stats/examples/).

- [Every CVE by Year and Severity](/reference/vulnerability/severity-by-year-stats/examples/default/): Without parameters, the number of CVEs per year and severity across the whole database.
- [OpenSSL CVEs by Year](/reference/vulnerability/severity-by-year-stats/examples/vendor-product/): OpenSSL's CVEs per year and severity.