---
title: "Report the catalogue's lifecycle split, whole or for one year"
method: GET
path: "/euvd/stats/status"
tags: ["euvd-stats"]
---

# Report the catalogue's lifecycle split, whole or for one year

`GET /euvd/stats/status`

## Request

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

## Query parameters

- `period` string

## Response `200`

Success.

- EUVDStatsStatus
  - `period` string: The year the counts cover, absent for the whole catalogue.
  - `published` integer: Records carrying a publication date, withdrawn ones included.
  - `reserved` integer: Records carrying a reservation date.
  - `state` EUVDStatsLifecycle
    - `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 in the catalogue. 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`: 2 info
  - added the new optional `query` request parameter `period`
  - added the non-success response with the status `400`
- **2026-09-21** `a850f2cbf0bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vulnerability-lookup/apis/vulnerability-lookup-api/changes/euvd/stats/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)