FortWatchFortWatchDocs
Menu

Get an asset

GEThttps://api.fortwatch.ai/app/assets/{id}
Scope assets:readOperation ID getAsset

One asset with its severity breakdown, open issues, scan schedules, detected technologies and, when its site sends visitors to a host its proof does not cover, which host.

Parameters

NameInTypeDescription
idrequiredpathinteger

Example request

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

Response 200

The request succeeded.

FieldTypeDescription
idrequirednumber
projectIdrequirednumber
namerequiredstring | null
typerequiredstring
valuerequiredstring
statusrequiredstring
canonicalUrlrequiredstring | null
resolvedIprequiredstring | null
cdnProviderrequiredstring | null
bucketProviderrequiredstring | null
lastCheckedAtrequiredstring (date-time) | null
failReasonrequiredstring | null
skippedRedirectHostrequiredstring | null
disabledScannerTypesrequiredstring[]
portScanModerequiredstring
nucleiMinSeverityrequiredstring
ownershipVerifiedAtrequiredstring (date-time) | null
ownershipTokenrequiredstring
ownershipMethodrequiredstring | null
createdAtrequiredstring (date-time)
updatedAtrequiredstring (date-time)
projectrequiredobject
scansrequiredobject[]
scanSchedulesrequiredobject[]
attentionReasonsrequiredstring[]
lastCompletedScanAtrequiredstring (date-time) | null
staleAfterDaysrequirednumber
severityCountsrequiredobject
criticalrequirednumber
highrequirednumber
mediumrequirednumber
lowrequirednumber
inforequirednumber
issuesrequiredobject[]
totalFindingsrequirednumber
openPortsrequiredobject[]
portrequirednumber
protocolrequiredstring
servicerequiredstring
versionrequiredobject | null
severityrequiredstring
namerequiredstring
latestFindingsrequiredobject[]
technologiesrequiredobject[]
findingTrendrequiredobject[]
scanIdrequirednumber
daterequiredstring (date-time)
totalrequirednumber
criticalrequirednumber
highrequirednumber
mediumrequirednumber
lowrequirednumber
detectedOsrequiredobject | null
issueSummaryrequiredobject
openrequirednumber
resolvedrequirednumber
dismissedrequirednumber
totalrequirednumber
lowOpenrequirednumber
lowResolvedrequirednumber
daysMonitoredrequirednumber
latestScreenshotrequiredobject | null
scannerSummaryrequiredobject[]
scannerrequiredstring
countrequirednumber
remediationProgressrequiredobject[]
weekrequiredstring (date)
openedrequirednumber
resolvedrequirednumber
skippedRedirectrequiredobject
hostrequiredstring
assetIdrequirednumber | nullThe workspace's asset for that host or its www twin
assetValuerequiredstring | nullThat asset's value: the host or its www twin
assetVerifiedrequiredbooleanThat asset is proven, so it is scanned on its own
signInServicerequiredbooleanA well-known sign-in service, which the customer cannot add
underAssetrequiredbooleanA name under the asset, which a DNS proof of the asset covers
json
{
  "id": 42,
  "projectId": 42,
  "name": "Production",
  "type": "string",
  "value": "app.example.com",
  "status": "string",
  "canonicalUrl": "string",
  "resolvedIp": "string",
  "cdnProvider": "string",
  "bucketProvider": "string",
  "lastCheckedAt": "2026-10-16T12:00:00.000Z",
  "failReason": "string",
  "skippedRedirectHost": "string",
  "disabledScannerTypes": [
    "string"
  ],
  "portScanMode": "string",
  "nucleiMinSeverity": "string",
  "ownershipVerifiedAt": "2026-10-16T12:00:00.000Z",
  "ownershipToken": "string",
  "ownershipMethod": "string",
  "createdAt": "2026-10-16T12:00:00.000Z",
  "updatedAt": "2026-10-16T12:00:00.000Z",
  "project": {},
  "scans": [
    {}
  ],
  "scanSchedules": [
    {}
  ],
  "attentionReasons": [
    "string"
  ],
  "lastCompletedScanAt": "2026-10-16T12:00:00.000Z",
  "staleAfterDays": 1,
  "severityCounts": {
    "critical": 1,
    "high": 1,
    "medium": 1,
    "low": 1,
    "info": 1
  },
  "issues": [
    {}
  ],
  "totalFindings": 1,
  "openPorts": [
    {
      "port": 1,
      "protocol": "string",
      "service": "string",
      "version": {},
      "severity": "string",
      "name": "Production"
    }
  ],
  "latestFindings": [
    {}
  ],
  "technologies": [
    {}
  ],
  "findingTrend": [
    {
      "scanId": 42,
      "date": "2026-10-16T12:00:00.000Z",
      "total": 1,
      "critical": 1,
      "high": 1,
      "medium": 1,
      "low": 1
    }
  ],
  "detectedOs": {},
  "issueSummary": {
    "open": 1,
    "resolved": 1,
    "dismissed": 1,
    "total": 1,
    "lowOpen": 1,
    "lowResolved": 1
  },
  "daysMonitored": 1,
  "latestScreenshot": {},
  "scannerSummary": [
    {
      "scanner": "string",
      "count": 1
    }
  ],
  "remediationProgress": [
    {
      "week": "string",
      "opened": 1,
      "resolved": 1
    }
  ],
  "skippedRedirect": {
    "host": "app.example.com",
    "assetId": 42,
    "assetValue": "string",
    "assetVerified": true,
    "signInService": true,
    "underAsset": true
  }
}

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.