CEcensys
Threat Hunting
Adversary Investigation

Investigations: List jobs

Changed on

List the AI investigations you have started. The most recent investigations are listed first and only investigations that have not passed their retention period are shown. Results are paginated and include investigations started in the Platform UI as well as through the API.<br><br>To use this endpoint, your organization must have access to the Adversary Investigation module.<br><br>This endpoint does not cost any credits to execute.

get/v3/threat-hunting/investigations/jobs

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v3/threat-hunting/investigations/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 investigations to return per page. Zero or omitted returns at most 50; values above 200 are reduced to 200.

page_tokenstring

Pagination token from the next_page_token of a previous response. Omit it to start from the first page.

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

Investigations retrieved successfully

Example response

{
  "result": {
    "jobs": [
      {
        "job_id": "550e8400-e29b-41d4-a716-446655440000",
        "state": "completed"
      }
    ]
  }
}

Changes