Enhanced issue filtering for the export API

Improved

We're updating the stable Export API (version 2024-10-15) to include more granular filtering for the issues dataset. You can now filter your export request payloads using additional parameters, including issue status, issue type, and project origin. We've also added support for advanced filters such as common vulnerabilities and exposures (CVE) ID, reachability, and National Vulnerability Database (NVD) severity to help you refine your reporting.

We want to make data consumption more manageable and relevant for your specific workflows. Previously, these fields were available as export columns but could not be used to filter the initial request. By adding these parameters directly to the API contract, we're enabling you to reduce noise and achieve parity between our user interface (UI) reporting and your automated exports.

You can now customize your issue exports by applying the following new filters to your API requests:

  • ISSUE_STATUS: Filter by Open, Resolved, or Ignored.

  • ISSUE_TYPE: Limit results to vulnerabilities or licenses.

  • PROJECT_ORIGIN: Filter by source, such as CLI, GitHub, or Jenkins.

  • PROJECT_TARGET_REF: Target specific branches or artifacts.

  • CVE: Search for a specific vulnerability ID.

  • NVD_SEVERITY: Filter based on external severity ratings.

  • REACHABILITY: Separate reachable from unreachable vulnerabilities.

  • PROJECT_TARGET_DISPLAY_NAME: Use human-readable names for your reports.

To learn more, visit Export in our user documentation.

Headshot of Sara Meadzinger

Sara Meadzinger | Staff Product Manager