Skip to main content
GET
List findings

Authorizations

Authorization
string
header
required

A Tolmo API token, sent as Authorization: Bearer <token>. Either a user token (usr_tok.*, minted by tolmo auth login, scoped to your own permissions) or an org API token created in the Tolmo app, for CI and automation.

Path Parameters

orgSlug
string
required

Query Parameters

status
enum<string>
Available options:
open,
in_review,
closed,
acknowledged,
false_positive,
canceled
severity
enum<string>
Available options:
critical,
high,
medium,
low,
info
statuses
Available options:
open,
in_review,
closed,
acknowledged,
false_positive,
canceled
statusExcluded
Available options:
open,
in_review,
closed,
acknowledged,
false_positive,
canceled
severities
Available options:
critical,
high,
medium,
low,
info
severityExcluded
Available options:
critical,
high,
medium,
low,
info
source
sourceExcluded
agent
agentExcluded
q
string
Maximum string length: 512
createdAfter
string
Pattern: ^\d{4}-\d{2}-\d{2}$
createdBefore
string
Pattern: ^\d{4}-\d{2}-\d{2}$
updatedAfter
string
Pattern: ^\d{4}-\d{2}-\d{2}$
updatedBefore
string
Pattern: ^\d{4}-\d{2}-\d{2}$
sortBy
enum<string>
Available options:
severity,
status,
created,
updated,
createdAt,
updatedAt
sortDir
enum<string>
Available options:
asc,
desc
page
integer
Required range: 1 <= x <= 10000
pageSize
integer
Required range: 1 <= x <= 100
includeDrafts
boolean
draftsOnly
boolean
limit
integer
Required range: 1 <= x <= 100
idsOnly
boolean
excludeIds
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Default Response

items
object[]
required
total
integer
required
Required range: 0 <= x <= 9007199254740991
page
integer
required
Required range: 0 < x <= 9007199254740991
pageSize
integer
required
Required range: 0 < x <= 9007199254740991
publishedTotal
integer
Required range: 0 <= x <= 9007199254740991