v42
latestSwagger 2.0GNU Affero General Public License version 3raw.githubusercontent.com2026-08-0111655431.4 KBRetrieve vulnerabilities with optional filters
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. product : str Optional product name to filter vulnerabilities (case-insensitive). If set, the endpoint returns vulnerabilities related to this product across all vendors. Use with assigner to further narrow results. assigner : str Optional CNA/assigner short name to filter results (case-insensitive). Only effective when used with product or vendor filters. light : str If '1', returns only (vulnerability_id, source) instead of full details. with_meta : str If 'true', includes metadata for each vulnerability. Ignored in light mode. with_linked : str If 'true', includes linked vulnerabilities for each result. Ignored in light mode. with_comments : str If 'true', includes comments for each result. Ignored in light mode. with_bundles : str If 'true', includes bundles for each result. Ignored in light mode. with_sightings : str If 'true', includes sightings for each result. Ignored in light mode.
Returns
list[dict[str, Any]] | list[tuple[str, str | None]] Full vulnerability details or minimal tuples if light mode is enabled.
Response
Success