Get the Elasticsearch query for a rule

Base URL: https://{kibana_url}

GET /api/alerting/rule/{id}/query_inspector

Auth

Returns the Elasticsearch query that a rule executes, and optionally its response.

Path parameters

id string required: The identifier for the rule.

Query parameters

mode enum · default: build: The inspection mode. Use "build" to return only the query, or "execute" to run the query and include the response.; Values: build execute
alert_id string: The alert document ID. When provided, the query inspector uses the evaluation time range from the alert instead of the current time.

Responses

Indicates a successful call.

application/json

queries object[] · max items: 1000 required

400

Indicates the rule type is not supported or the request parameters are invalid.

404

Indicates a rule with the specified rule ID does not exist.

View as Markdown

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

GET kbn:/api/alerting/rule/ID/query_inspector

Generated from the API spec

curl Shell

curl -X GET "${KIBANA_URL}/api/alerting/rule/${ID}/query_inspector" \
  -H "Authorization: ApiKey ${API_KEY}"

Generated from the API spec

Response

{
  "queries": [
    {
      "index": "metrics-*",
      "request": {
        "aggs": {
          "groupings": {
            "composite": {
              "size": 500,
              "sources": []
            }
          }
        },
        "query": {
          "bool": {
            "filter": [
              {
                "range": {
                  "@timestamp": {
                    "gte": "2026-01-01T00:00:00.000Z",
                    "lte": "2026-01-01T00:05:00.000Z"
                  }
                }
              }
            ]
          }
        },
        "size": 0
      }
    }
  ]
}