July 21st, 2025

πŸ”„ API Change Notice – Flattened findings Data in Vulnerability Endpoints

πŸ“… Release Date: 21 July 2025

Affected Endpoints:

  • GET /api/v2/vulns

  • GET /api/v2/scan/:scan_id


πŸ†• What’s Changed:

We’ve simplified the structure of the response payload for the endpoints listed above by removing the results array and introducing a flattened findings array instead.


βœ… Benefits:

  • Easier to parse – You no longer need to loop through nested results objects.

  • Cleaner output – All relevant vulnerability information is now directly accessible in a single array (findings).

  • Improved performance – Smaller payloads and fewer nesting levels.


πŸ“¦ Before (Old Structure)

{
  "results": [
    {
      "scanner": "sast",
      "findings": [
        {
          "id": "...",
          "vuln": "...",
          "severity": "...",
          ...
        }
      ]
    }
  ]
}

πŸš€ Now (New Structure)

{
  "findings": [
    {
      "id": "...",
      "scanner": "sast",
      "vuln": "...",
      "severity": "...",
      ...
    }
  ]
}

πŸ”§ Action Required:

If you’re consuming these APIs, please update your client-side logic or integrations to expect a flat findings array instead of nested results.findings.