List incoming reports
const url = 'https://zkao.io/api/v1/projects/example/reports?page=1&limit=50&status=NEW';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://zkao.io/api/v1/projects/example/reports?page=1&limit=50&status=NEW' \ --header 'Authorization: Bearer <token>'Requires scope: read. Vulnerability reports the programme has received, newest first. Optionally filter by status.
publicId is what investigateReport takes. intakeState says whether the report has been read and split into claims yet: an investigation waits for COMPLETE, so a PENDING or RUNNING report is one to come back to rather than one to retry.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Query Parameters
Section titled “Query Parameters”Only reports in this triage status.
Responses
Section titled “ Responses ”OK
object
object
The identifier investigateReport takes.
How it arrived, including GitHub private reports, API submissions, and file imports.
Whether the report has been read and split into claims. An investigation waits for COMPLETE.
How the investigation is going, or null if none has run.
The GitHub advisory it arrived as.
Example
{ "items": [ { "claimedSeverity": "CRITICAL", "status": "NEW", "intakeState": "PENDING", "evaluationState": "QUEUED" } ]}Invalid request
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}Missing, malformed, expired, or revoked token
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}The token lacks the required scope
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}Resource not in this token’s project or repo allowlist
object
object
Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.
Example
{ "error": { "code": "unauthorized" }}