FortWatchFortWatchDocs
Menu

List a scan's findings

GEThttps://api.fortwatch.ai/app/scans/{id}/findings
Scope scans:readPagedOperation ID listScanFindings

What the scan found; info findings are left out unless asked for.

Paged: send page and limit (100 by default, at most 500); the total is in X-Total-Count (paging).

Parameters

NameInTypeDescription
idrequiredpathinteger
severityquerystring
pagequeryintegerThe page, from 1.
limitqueryintegerRows per page: an API key or OAuth token gets 100 when it sends none, at most 500.

Example request

curl -X GET "https://api.fortwatch.ai/app/scans/42/findings?limit=100" \
  -H "Authorization: Bearer $FORTWATCH_API_KEY"

Response 200

The request succeeded.

FieldTypeDescription
idrequirednumber
scannerrequiredstring
severityrequiredstring
templateIdrequiredobject | null
namerequiredstring
descriptionrequiredobject | null
matchedAtrequiredobject | null
tagsrequiredobject | null
cveIdsrequiredobject | null
cvssScorerequiredobject | null
remediationrequiredobject | null
referencerequiredobject | null
createdAtrequiredstring (date-time)
issuerequiredobject
idrequirednumber
statusrequiredstring
titlerequiredstring
categoryrequiredstring
json
[
  {
    "id": 42,
    "scanner": "string",
    "severity": "string",
    "templateId": {},
    "name": "Production",
    "description": {},
    "matchedAt": {},
    "tags": {},
    "cveIds": {},
    "cvssScore": {},
    "remediation": {},
    "reference": {},
    "createdAt": "2026-10-16T12:00:00.000Z",
    "issue": {
      "id": 42,
      "status": "string",
      "title": "string"
    },
    "category": "string"
  }
]

Errors

400The request is not valid: a field is missing or has the wrong shape (the message names it).
401No valid credentials: the API key or access token is missing, revoked or expired (INVALID_API_KEY, INVALID_TOKEN).
403Not allowed: the key or token lacks this scope (SCOPE_REQUIRED), the route is dashboard-only (SESSION_REQUIRED), or a plan limit applies.
404Not found in your workspace.
429Too many requests (RATE_LIMITED): wait the seconds Retry-After gives.