List a scan's findings
GEThttps://api.fortwatch.ai/app/scans/{id}/findings
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
| Name | In | Type | Description |
|---|---|---|---|
idrequired | path | integer | |
severity | query | string | |
page | query | integer | The page, from 1. |
limit | query | integer | Rows 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.
| Field | Type | Description |
|---|---|---|
idrequired | number | |
scannerrequired | string | |
severityrequired | string | |
templateIdrequired | object | null | |
namerequired | string | |
descriptionrequired | object | null | |
matchedAtrequired | object | null | |
tagsrequired | object | null | |
cveIdsrequired | object | null | |
cvssScorerequired | object | null | |
remediationrequired | object | null | |
referencerequired | object | null | |
createdAtrequired | string (date-time) | |
issuerequired | object | |
idrequired | number | |
statusrequired | string | |
titlerequired | string | |
categoryrequired | string |
[
{
"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
400 | The request is not valid: a field is missing or has the wrong shape (the message names it). |
401 | No valid credentials: the API key or access token is missing, revoked or expired (INVALID_API_KEY, INVALID_TOKEN). |
403 | Not allowed: the key or token lacks this scope (SCOPE_REQUIRED), the route is dashboard-only (SESSION_REQUIRED), or a plan limit applies. |
404 | Not found in your workspace. |
429 | Too many requests (RATE_LIMITED): wait the seconds Retry-After gives. |
Every code is explained in Errors.