---
title: "Search CVEs with disclosure summaries"
description: "Lists `kind=cve` ontology entities with compact disclosure summaries and links. Preserves public entity IDs, cursor pagination, and `fields[entities]`. `q` searches CVE identifiers. Full affected-version arrays and source records are available from `GET /api/v2/cyber/cves/{cveId}`. Reading does not trigger collection."
canonical: https://y2.dev/docs/api/reference/intel/listCVEsV2/
---

Endpoint Reference[Intel](https://y2.dev/docs/api/reference/intel)

# Search CVEs with disclosure summaries

Lists \`kind=cve\` ontology entities with compact disclosure summaries and links. Preserves public entity IDs, cursor pagination, and \`fields\[entities]\`. \`q\` searches CVE identifiers. Full affected-version arrays and source records are available from \`GET /api/v2/cyber/cves/{cveId}\`. Reading does not trigger collection.

`GET https://api.y2.dev/api/v2/cyber/cves`

- Operation ID: `listCVEsV2`
- Required scopes: `intel:cyber`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `fields[entities]` | query | string | No | Comma-separated allowlist of entity fields. Identity and links remain present. |
| `q` | query | string | No | CVE identifier search; in catalog mode, also searches vendor, product and disclosure text (up to 160 characters). |
| `catalog` | query | `true` | No | Use the searchable collected disclosure catalog with priority filters. |
| `severity` | query | `all`, `critical-high`, `critical`, `high`, `medium`, `low`, `info`, `unscored` | No |  |
| `remediation` | query | `any`, `fix_published`, `workaround_published`, `unknown` | No | Source-reported remediation; unknown does not establish that no fix exists. |
| `kev` | query | `any`, `true` | No | Restrict to known exploited CVEs listed by CISA. |
| `sort` | query | `updated`, `cvss` | No | Ordering without a search query. CVSS uses latest source update as its tie-breaker. |
| `limit` | query | integer | No | Maximum number of CVEs to return |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | CVE entities with compact disclosure summaries | `CVEListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `PublicEntity` | Entities filtered to `kind=cve` |
| `data[].cve` | `CVESummary` |  |
| `data[].source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data[].id` | string |  |
| `data[].type` | string |  |
| `data[].kind` | `EntityKind` |  |
| `data[].name` | string |  |
| `data[].aliases[]` | array of string |  |
| `data[].externalIds` | object |  |
| `data[].attributes` | object |  |
| `data[].footprint` | object |  |
| `data[].createdAt` | string (date-time) |  |
| `data[].updatedAt` | string (date-time) |  |
| `data[].links` | `PublicResourceLinks` |  |
| `meta` | `PublicListMeta` |  |
| `meta.count` | integer |  |
| `meta.pageCount` | integer |  |
| `meta.limit` | integer |  |
| `meta.isDone` | boolean |  |
| `meta.hasMore` | boolean |  |
| `meta.nextCursor` | string or null |  |
| `meta.asOf` | string (date-time) |  |
| `meta.page` | `PublicPageMeta` |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |
