Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
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

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.

page_sizeinteger

Number of results per page (max 100)

Number of results per page (max 100)

page_tokenstring

Pagination token from previous response

Pagination token from previous response

host_idstring

Filter by host IP address.

Example:8.8.8.8

Filter by host IP address.

webproperty_idstring

Filter by web property (hostname:port).

Example:example.com:443

Filter by web property (hostname:port).

certificate_idstring

Filter by certificate SHA-256 fingerprint.

Example:3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf

Filter by certificate SHA-256 fingerprint.

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.

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"
        }
      }
    ]
  }
}