---
title: "Retrieves information about CVE IDs after applying the query parameters as filters (accessible to all registered users)"
method: GET
path: "/cna/cve-id"
tags: ["cna"]
---

# Retrieves information about CVE IDs after applying the query parameters as filters (accessible to all registered users)

`GET /cna/cve-id`

## Query parameters

- `state` 'RESERVED' | 'PUBLISHED' | 'REJECTED'
- `cve_id_year` string
- `time_reserved.lt` string, date-time
- `time_reserved.gt` string, date-time
- `time_modified.lt` string, date-time
- `time_modified.gt` string, date-time
- `page` integer
- `sort_by` 'created' | 'modified'
- `sort_dir` 'asc' | 'desc'
- `search` string

## Headers

- `CVE-API-ORG` string
- `CVE-API-USER` string
- `CVE-API-KEY` string

## Response `200`

Filtered CVE IDs

- CveIdListResponseModel
  - `totalCount` integer — Total CVE records found
  - `itemsPerPage` integer — Number of CVE records in a page
  - `pageCount` integer — Total number of pages
  - `currentPage` integer — Current page
  - `prevPage` integer — Previous page
  - `nextPage` integer — Next page
  - `cve_ids` object[]
    - `cve_id` string — ^CVE-[0-9]{4}-[0-9]{4,}$
    - `cve_year` string — ^[0-9]{4}$
    - `owning_cna` string — The shortname for the organization that owns the CVE ID
    - `state` 'RESERVED' | 'PUBLISHED' | 'REJECTED'
    - `requested_by` object
      - `cna` string — The shortname for the organization of the user that requested the ID
      - `user` string — The username for the account that requested the ID
    - `reserved` string, date-time — The time the ID was reserved
    - `time` object
      - `created` string, date-time — The time the ID was created
      - `modified` string, date-time — The last time the ID was modified

## Other responses

- `400` — Bad Request
- `401` — Not Authenticated
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/vulnerability-lookup/apis/vulnerability-lookup-api.md) · [All operations](https://skmtc.net/vulnerability-lookup/apis/vulnerability-lookup-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vulnerability-lookup/vulnerability-lookup-api/versions/e6ef25beb687/schema)
