CEcensys
Threat Hunting

Get scan status

Retrieve the current status of a scan by its ID. This endpoint works for both Live Discovery scans and Live Rescans.<br><br>Use this endpoint to check whether a Live Discovery or Live Rescan scan has finished, so automation knows when fresh data is ready to pull.<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all enterprise customers. This endpoint does not cost any credits to execute.

get/v3/threat-hunting/scans/{scan_id}

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v3/threat-hunting/scans/{scan_id}
  • Auth
    HTTP bearer

Path parameters

scan_idstring uuid required

The unique identifier of the tracked scan

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

Response

OK

Changes

No recorded changes to this operation across all 2 revisions of this API.