Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Global Data

Live Rescan: Initiate a new rescan

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>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.

post/v3/global/scans/rescan

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

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

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

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.

Request body

Example request

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

Response

OK