List discovered hostnames

GEThttps://api.fortwatch.ai/app/discovery/hosts

Scope assets:readPagedOperation ID listDiscoveredHosts

Hostnames public sources know under the workspace's proven domains, with whether they resolve and their status: new, added or ignored.

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

Parameters

Name	In	Type	Description
`projectId`	query	integer
`domain`	query	string
`status`	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/discovery/hosts?limit=100" \
  -H "Authorization: Bearer $FORTWATCH_API_KEY"

Response 200

The request succeeded.

Field	Type	Description
`id`required	number
`projectId`required	number
`domain`required	string
`host`required	string
`sources`required	string[]
`resolves`required	object \| null
`resolvedIp`required	object \| null
`cname`required	object \| null
`wildcard`required	object \| null
`status`required	string
`assetId`required	object \| null
`firstSeenAt`required	string (date-time)
`lastSeenAt`required	string (date-time)
`project`required	object
`id`required	number
`name`required	string
`color`required	string

json

[
  {
    "id": 42,
    "projectId": 42,
    "domain": "app.example.com",
    "host": "app.example.com",
    "sources": [
      "string"
    ],
    "resolves": {},
    "resolvedIp": {},
    "cname": {},
    "wildcard": {},
    "status": "string",
    "assetId": {},
    "firstSeenAt": "2026-10-16T12:00:00.000Z",
    "lastSeenAt": "2026-10-16T12:00:00.000Z",
    "project": {
      "id": 42,
      "name": "Production",
      "color": "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.
`429`	Too many requests (RATE_LIMITED): wait the seconds Retry-After gives.

Every code is explained in Errors.

This page as Markdown