Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Threat Hunting
Adversary Investigation

CensEye: Get job results

Retrieve the results of a completed CensEye pivot analysis job. Each result contains a count and the field-value pairs that were analyzed. Results may be empty if the job is still running.<br><br>Results are paginated. Use the next_page_token from the response to fetch subsequent pages.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.

get/v3/threat-hunting/censeye/jobs/{job_id}/results

Path parameters

job_idstring uuid required

The unique identifier of the CensEye job.

The unique identifier of the CensEye job.

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

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": {
    "results": [
      {
        "field_value_pairs": [
          {
            "field": "host.services.port",
            "value": "80"
          }
        ]
      }
    ]
  }
}