FortWatchFortWatchDocs
Menu

Get the most vulnerable assets

GEThttps://api.fortwatch.ai/app/reports/vulnerable-assets
Scope reports:readOperation ID getVulnerableAssets

The 10 assets with the most serious open issues in the period.

Parameters

NameInTypeDescription
projectIdqueryintegerOnly this project's numbers.
assetIdqueryintegerOnly this asset's numbers.
fromquerystring
toquerystring

Example request

curl -X GET "https://api.fortwatch.ai/app/reports/vulnerable-assets" \
  -H "Authorization: Bearer $FORTWATCH_API_KEY"

Response 200

The request succeeded.

FieldTypeDescription
idrequirednumber
valuerequiredstring
typerequiredstring
projectrequiredobject
findingsCountrequirednumber
scansCountrequirednumber
json
[
  {
    "id": 42,
    "value": "app.example.com",
    "type": "string",
    "project": {},
    "findingsCount": 1,
    "scansCount": 1
  }
]

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.
429Too many requests (RATE_LIMITED): wait the seconds Retry-After gives.