---
title: "GET /stats/vulnerability/status"
method: GET
path: "/stats/vulnerability/status"
tags: ["stats"]
---

# GET /stats/vulnerability/status

`GET /stats/vulnerability/status`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/stats/vulnerability/status`
- Auth: API key in header `X-API-KEY`

Returns the lifecycle split of a source, whole or for one year.

## Query parameters

- `source` string
- `period` string

## Response `200`

Success.

- StatsStatus
  - `period` string: The year the counts cover, absent for the whole source.
  - `published` integer: Records carrying a publication date, withdrawn ones included.
  - `reserved` integer: Records carrying a reservation date, which is not the same as records awaiting publication: on the CVE list every record carries one, so this equals `total` there.
  - `source` string: The source reported on.
  - `state` StatsLifecycle
    - `published` integer: Records whose current state is PUBLISHED.
    - `rejected` integer: Records whose current state is REJECTED, i.e. withdrawn.
    - `reserved` integer: Records whose current state is RESERVED.
  - `total` integer: Records held. Absent with a period: the base index is scored by a record's last update, so a year of it would count records touched in that year rather than records of it.

## Other responses

- `400`: The request could not be satisfied.

## Changes

- **2026-10-09** `aee06988b549`: 1 info
  - added the new optional `query` request parameter `period`
- **2026-09-21** `a850f2cbf0bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vulnerability-lookup/apis/vulnerability-lookup-api/changes/stats/vulnerability/status/get.md)

---

[API](https://skmtc.dev/vulnerability-lookup/apis/vulnerability-lookup-api.md) - [All operations](https://skmtc.dev/vulnerability-lookup/apis/vulnerability-lookup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vulnerability-lookup/apis/vulnerability-lookup-api/revisions/b4dedf027493?raw)