CEcensys
Threat Hunting

CensEye: List jobs

List CensEye pivot analysis jobs for the current organization. Results are paginated. Optionally filter by asset (host, web property, or certificate).

get/v3/threat-hunting/censeye/jobs

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v3/threat-hunting/censeye/jobs
  • 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
page_sizeinteger

Number of results per page (max 100)

page_tokenstring

Pagination token from previous response

host_idstring

Filter by host IP address.

Example:8.8.8.8
webproperty_idstring

Filter by web property (hostname:port).

Example:example.com:443
certificate_idstring

Filter by certificate SHA-256 fingerprint.

Example:3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf

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

Example response

{
  "result": {
    "jobs": [
      {
        "job_id": "550e8400-e29b-41d4-a716-446655440000",
        "result_count": 42,
        "state": "completed",
        "target": {
          "certificate_id": "3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf",
          "host_id": "8.8.8.8",
          "webproperty_id": "example.com:443"
        }
      }
    ]
  }
}

Changes

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