List Findings

Lists red-team findings across your organization, optionally filtered by target and lifecycle status. Defaults to ACTIVE findings. Results use offset pagination and include a total count.

GET /v1/findings

List Findings

cURL

curl --request GET \
  --url https://api.mindfort.app/v1/findings \
  --header 'Authorization: Bearer <token>'

200

{
  "findings": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "severity_score": 123
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

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 informational secured probe findings (severity info)

severity · enum<string>

Filter by severity

Available options: critical, high, medium, low, 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

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

200

application/json

Findings returned successfully

findings · object[]

Show child attributes

total · integer

Total findings matching the query

limit · integer

Maximum findings returned

offset · integer

Number of findings skipped