Sign in
vulnerability

Retrieve 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.

get/vulnerability/

Response

Success

Changes

Changed in 5 of the 42 revisions of this API.115

  • c816fd4ffff14See the full diff
    • ○

      added the new optional query request parameter with_bundles to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter with_comments to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter with_linked to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter with_sightings to all path's operations

      new-optional-request-default-parameter-to-existing-path

  • 92f7157cbff01See the full diff
    • ○

      added the new optional query request parameter with_meta to all path's operations

      new-optional-request-default-parameter-to-existing-path

  • 9c1baef65e8d1See the full diff
    • ○

      added the new optional query request parameter product to all path's operations

      new-optional-request-default-parameter-to-existing-path

  • d87b1cfd73209See the full diff
    • ○

      endpoint added

      endpoint-added

    • ○

      added the new optional query request parameter cwe to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter date_sort to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter light to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter page to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter per_page to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter since to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter sort_order to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter source to all path's operations

      new-optional-request-default-parameter-to-existing-path

  • 28bfb33cc1fb1See the full diff
    • ▲

      api removed without deprecation

      api-removed-without-deprecation