---
title: "Retrieves information about CVE IDs after applying the query parameters as filters (accessible to registered users, Secretariat, and Bulk Download)"
method: GET
path: "/cve-id"
tags: ["CVE ID"]
---

# Retrieves information about CVE IDs after applying the query parameters as filters (accessible to registered users, Secretariat, and Bulk Download)

`GET /cve-id`

<h2>Access Control</h2>  <p>Registered users can access this endpoint. Secretariat and Bulk Download organizations can retrieve CVE IDs across organizations; other users are limited to CVE IDs owned by their own organization.</p>  <h2>Expected Behavior</h2>  <p><b>Regular, CNA & Admin Users:</b> Retrieves filtered CVE IDs owned by the user's organization</p>  <p><b>Secretariat:</b> Retrieves filtered CVE IDs owned by any organization</p>  <p><b>Bulk Download:</b> Retrieves filtered CVE IDs owned by any organization with owner and requester details redacted</p>

## 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

## Headers

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

## Response `200`

A filtered list of information about CVE IDs owned by the organization, along with pagination fields if results span multiple pages of data

- ListCveIdsResponseJson — unresolved $ref

## Other responses

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

---

[API](https://skmtc.net/cveproject/apis/cve-services-api.md) · [All operations](https://skmtc.net/cveproject/apis/cve-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cveproject/cve-services-api/revisions/37d9d2a0b112/schema)