FortWatchFortWatchDocs
Menu

Summarize discovery

GEThttps://api.fortwatch.ai/app/discovery/summary
Scope assets:readOperation ID getDiscoverySummary

One row per project and registrable domain: how many hostnames are new, added or ignored, and the last discovery run.

Parameters

NameInTypeDescription
projectIdqueryinteger

Example request

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

Response 200

The request succeeded.

FieldTypeDescription
projectIdrequirednumber
domainrequiredstring
newrequirednumber
newLiverequirednumber
addedrequirednumber
ignoredrequirednumber
lastRunrequiredobject
idrequirednumber
projectIdrequirednumber
domainrequiredstring
statusrequiredstring
foundCountrequiredobject | null
newCountrequiredobject | null
wildcardDnsrequiredobject | null
errorrequiredobject | null
finishedAtrequiredstring (date-time) | null
createdAtrequiredstring (date-time)
json
[
  {
    "projectId": 42,
    "domain": "app.example.com",
    "new": 1,
    "newLive": 1,
    "added": 1,
    "ignored": 1,
    "lastRun": {
      "id": 42,
      "projectId": 42,
      "domain": "app.example.com",
      "status": "string",
      "foundCount": {},
      "newCount": {},
      "wildcardDns": {},
      "error": {},
      "finishedAt": "2026-10-16T12:00:00.000Z",
      "createdAt": "2026-10-16T12:00:00.000Z"
    }
  }
]

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.