---
title: "Retrieve vulnerabilities with optional filters"
method: GET
path: "/vulnerability/"
tags: ["vulnerability"]
---

# Retrieve vulnerabilities with optional filters

`GET /vulnerability/`

Retrieve vulnerabilities with optional filtering and pagination.

Supports light mode for minimal data (returns only vulnerability ID and source).
Returns full vulnerability details by default, or only IDs and sources in light mode.

Query Parameters
----------------
source : str
    Optional source to filter vulnerabilities (e.g., 'CVE', 'GHSA', 'PySec').
per_page : int, default=30
    Maximum number of results (capped at 100).
date_sort : str
    Field to sort by. Options: '', 'published', 'updated', 'reserved'.
sort_order : str
    Sort order: 'asc' or 'desc'.
since : str
    Retrieve vulnerabilities published/updated after the specified date.
page : int
    Pagination page number.
cwe : str
    Filter vulnerabilities by a specific CWE ID.
light : str
    If '1', returns only `(vulnerability_id, source)` instead of full details.

Returns
-------
list[dict[str, Any]] | list[tuple[str, str | None]]
    Full vulnerability details or minimal tuples if light mode is enabled.

## Response `200`

Success

## Changes

- **2025-10-03** `d87b1cfd7320` — 9 info
  - endpoint added
  - added the new optional `query` request parameter `cwe` to all path's operations
  - added the new optional `query` request parameter `date_sort` to all path's operations
  - added the new optional `query` request parameter `light` to all path's operations
  - …5 more
- **2024-06-05** `28bfb33cc1fb` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/vulnerability-lookup/apis/vulnerability-lookup-api/changes/vulnerability/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-service-production.skmtc.workers.dev/v1/apis/vulnerability-lookup/vulnerability-lookup-api/revisions/d87b1cfd7320/schema)