API Reference

Get scan status

get
https://api.platform.censys.io/v3/global/scans/

Retrieve the current status of a scan by its ID. This endpoint works for both Live Discovery scans and Live Rescans.

If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.

This endpoint is available to all Enterprise customers. This endpoint does not cost any credits to execute.

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

The unique identifier of the tracked scan

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/vnd.censys.api.v3.trackedscan.v1+json

Generated from available response content types

Allowed:
Responses

Updated 4 days ago

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

Updated 4 days ago