Find and/or aggregate attack discovery alerts

Base URL: https://{kibana_url}

POST /api/detection_engine/attacks/search
POST /s/{space_id}/api/detection_engine/attacks/search

Auth

Find and/or aggregate attack discovery alerts that match the given query. Searches scheduled and ad hoc attack discovery alert indices for the active space only.

Path parameters

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.

Request body

Search and/or aggregation query

_source union boolean | string | string[]
aggs object
fields string[]
query object
runtime_mappings object
size integer · min: 0
sort union oneOf: One of: (string | object)[] or string | object
track_total_hits boolean

Responses

Successful response

application/json

Response Type: object

Invalid input data response

application/json

One of:

error string required
message string required
statusCode integer required

Unsuccessful authentication response

application/json

error string required
message string required
statusCode integer required

Internal server error response

application/json

message string required
status_code integer required

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST kbn:/api/detection_engine/attacks/search
{
  "query": {
    "ids": {
      "values": [
        "80e1383f856e67c1b7f7a1634744fa6d66b6e2ef7aa26d226e57afb5a7b2b4a1"
      ]
    }
  }
}

Generated from the API spec

curl Shell

curl -X POST "${KIBANA_URL}/api/detection_engine/attacks/search" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "query": {
      "ids": {
        "values": [
          "80e1383f856e67c1b7f7a1634744fa6d66b6e2ef7aa26d226e57afb5a7b2b4a1"
        ]
      }
    }
  }'

Generated from the API spec

Response

{
  "_shards": {
    "failed": 0,
    "skipped": 0,
    "successful": 1,
    "total": 1
  },
  "hits": {
    "hits": [
      {
        "_id": "80e1383f856e67c1b7f7a1634744fa6d66b6e2ef7aa26d226e57afb5a7b2b4a1",
        "_index": ".internal.adhoc.alerts-security.attack.discovery.alerts-default-000001",
        "_score": 1,
        "_source": {
          "@timestamp": "2025-06-23T15:16:52.984Z",
          "kibana.alert.attack_discovery.alert_ids": [
            "ee183cf525d7e9d0f47d1b2bb928d760a0f53756ffa61edcf0672f71c986ac21",
            "46ebac989ca72439b14b57d32102543c17d5f33e0f6532d8a5c148949d8ff7b5"
          ],
          "kibana.alert.attack_discovery.title_with_replacements": "Widespread Malware Campaign via Compromised Account",
          "kibana.alert.workflow_status": "open"
        }
      }
    ],
    "max_score": 1,
    "total": {
      "relation": "eq",
      "value": 1
    }
  },
  "timed_out": false,
  "took": 1
}

{
  "error": "Bad Request",
  "message": "Failed to parse search request: unknown query clause in bool filter",
  "statusCode": 400
}

{
  "error": "Unauthorized",
  "message": "[security_exception\n\tRoot causes:\n\t\tsecurity_exception: unable to authenticate user [elastic] for REST request [/_security/_authenticate]]: unable to authenticate user [elastic] for REST request [/_security/_authenticate]",
  "statusCode": 401
}

{
  "message": "Internal Server Error",
  "status_code": 500
}

Path parameters

Request body { }

Responses

Request body