Skip to main content
GET
/
api
/
v1
/
scans
/
{scanId}
/
vulnerabilities
List vulnerabilities for a scan
curl --request GET \
  --url https://app.gecko.security/api/v1/scans/{scanId}/vulnerabilities \
  --header 'X-API-Key: <api-key>'
{ "version": "v1", "data": [ { "id": "2a7c9f10-3b1e-4f2d-9a33-1dcf8c7a1d01", "scanId": "00000000-0000-0000-0000-000000000001", "severity": 9.4, "confidenceScore": 8.5, "title": "Unbounded command template allows shell injection", "type": "Command Execution", "cwe": "CWE-78", "filePath": "services/reports/run_report.ts", "shortDescription": "User input is interpolated into a shell command without proper quoting.", "cvssVector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H" } ], "pagination": { "total": 1, "limit": 100, "offset": 0, "hasMore": false }, "filters": { "severity": null, "type": null, "cwe": null } }

Authorizations

​
X-API-Key
string
header
required

Team-scoped Gecko API key. Keys start with gk_.

Path Parameters

​
scanId
string<uuid>
required

Scan UUID.

Query Parameters

​
severity
number

Filter to vulnerabilities whose severity matches this value exactly.

Required range: 0 <= x <= 10
​
type
string

Filter vulnerabilities by type. Gecko performs a case-insensitive substring match.

​
cwe
string

Filter vulnerabilities by CWE. Gecko performs a case-insensitive substring match.

​
limit
integer
default:100

Maximum number of results to return. Gecko defaults to 100 and caps the value at 1000.

Required range: 1 <= x <= 1000
​
offset
integer
default:0

Number of results to skip before Gecko starts returning rows.

Required range: x >= 0

Response

A paginated list of vulnerabilities for the scan.

​
version
string
required
Allowed value: "v1"
​
data
object[]
required
​
pagination
object
required
​
filters
object
required