Skip to main content
GET
List Findings

Authorizations

Authorization
string
header
required

API key generated from the MindFort dashboard. Pass as Authorization: Bearer <your-api-key>.

Query Parameters

target_id
string<uuid>

Optional target UUID to filter findings

assessment_id
string<uuid>

Filter findings to a specific assessment run

exclude_secured
boolean
default:false

When true, omit secured probe findings

severity
enum<string>

Filter by severity. info is accepted as a deprecated alias for secured.

Available options:
critical,
high,
medium,
low,
secured,
info
status
enum<string>
default:ACTIVE

Filter by finding lifecycle status

Available options:
ACTIVE,
RESOLVED,
ARCHIVED
sort_by
enum<string>
default:severity

Sort mode for results

Available options:
severity,
created_at
order_direction
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Search finding ID, title, description, endpoint, or impact

Maximum string length: 500
status_filter
enum<string>

Filter by vulnerability status

Available options:
vulnerable,
secured,
all
active_only
boolean
default:false

When true, return only active findings

org_wide
boolean
default:false

Compatibility parameter. Results are organization-wide when target_id and assessment_id are omitted.

assigned_to_me
boolean
default:false

When true, return only findings assigned to the current user

assigned_to
string

Filter by assignee user ID

unassigned
boolean
default:false

When true, return only findings without an assignee

finding_type
enum<string>

Finding type. Only red-team findings are available through the public API.

Available options:
red-team
limit
integer
default:25

Maximum number of findings to return

Required range: 1 <= x <= 100
offset
integer
default:0

Number of records to skip for offset pagination

Required range: x >= 0

Response

Findings returned successfully

findings
PublicFindingSummary · object[]
required
total
integer
required
limit
integer
required
offset
integer
required
next_cursor
string | null
required