CEcensys
Global Data

Live Rescan: Initiate a new rescan

Changed on

Initiate a rescan for a known host service at a specific IP and port (ip:port) or hostname and port (hostname:port). This is equivalent to the Live Rescan feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to monitor the scan's status. After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>In a SOC environment, rescan to ensure triage, an investigation, or a hunt has the most accurate and current state. This includes information like whether C2 servers are still operational, or whether an organization's asset is still exposed to the internet.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.

post/v3/global/scans/rescan

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v3/global/scans/rescan
  • Auth
    HTTP bearer

Query parameters

organization_idstring uuid required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Example:11111111-2222-3333-4444-555555555555

Headers

X-Organization-IDstring uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Example:11111111-2222-3333-4444-555555555555

Request body

Example request

{
  "target": {
    "service_id": {
      "ip": "8.8.8.8",
      "port": 443,
      "protocol": "HTTP"
    }
  }
}

Response

OK

Changes