Live Discovery: Initiate a new scan

Initiate a scan to look for a currently unobserved service at a specific IP and port (ip:port) or hostname and port (hostname:port). This is equivalent to the Live Discovery feature available in the UI, but you can also target web properties in addition to hosts.

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.

This endpoint is available to organizations that have access to the Adversary Investigation module. It costs 15 credits to execute this endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
target
required
Query Params
uuid
required

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

Headers
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.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json