Skip to main content
GET
List the findings of one source

Authorizations

Authorization
string
header
required

JWT authentication token

Path Parameters

id
string<uuid>
required

Source id

Query Parameters

archived
boolean

True lists only archived findings, false only active ones. Omit to list both.

cursor
string

The next_cursor of the previous page.

Required string length: 1 - 200
limit
integer
default:50

Maximum number of findings. Defaults to 50.

Required range: 1 <= x <= 100

Response

One page of findings of the source

count
integer<int64>
required

Number of findings that match the filters (all pages).

findings
object[]
required
counts
object

The queue counts, read in the same snapshot as the page. Each facet ignores its own filter and applies the others; open means a stage other than closed.

history
object

Open findings (every stage but closed) over time, with the untriaged stage, the backlog, as a second series (untriaged). Filters: the source filters, severity, state, q and archived; stage, view, sla, verdict and include_snoozed do not narrow it. The last point is the current stage, so its open is the open total of counts read with include_snoozed=true and no stage, view or sla filter. Earlier points are estimates: severity is today's severity, snooze state is not rewound, and a finding the source stopped listing without a review is not counted. A finding is untriaged from its creation to its first exit (its first run other than a retest, else the legacy handoff row of a built-in finding, or its first accepted, declined or duplicate review event) or to its closing time; one untriaged now that had left it (failed run, returned to queue) is untriaged again from its latest return, and returns in between are not modelled.

next_cursor
string | null

Pass as cursor to read the next page. Null on the last page.

quality
object[]

With include=history: one entry per source that has a finding in scope, over the last weeks weeks.