Get a watchlist by ID

Base URL: https://{kibana_url}

GET /api/entity_analytics/watchlists/{id}

Auth

Retrieves the details of an entity analytics watchlist by its unique identifier.

Path parameters

id string required: Unique ID of the watchlist

Response

Watchlist details

application/json

createdAt string · format: date-time: Timestamp indicating when the watchlist was created
description string: Description of the watchlist
entityCount number: Number of entities in the watchlist
entitySourceIds string[]: List of entity source IDs associated with the watchlist
hasManualEntities boolean: Indicates whether the watchlist contains manually assigned entities
id string: The unique ID of the watchlist
managed boolean required: Indicates if the watchlist is managed by the system
name string required: The name of the watchlist
riskModifier number required: Risk score modifier associated with the watchlist
updatedAt string · format: date-time: Timestamp indicating when the watchlist was last updated

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

GET kbn:/api/entity_analytics/watchlists/ID

Generated from the API spec

curl Shell

curl -X GET "${KIBANA_URL}/api/entity_analytics/watchlists/${ID}" \
  -H "Authorization: ApiKey ${API_KEY}"

Generated from the API spec

Response

{
  "createdAt": "2026-01-28T12:00:00.000Z",
  "description": "High risk vendor watchlist",
  "id": "watchlist-123",
  "managed": false,
  "name": "High Risk Vendors",
  "riskModifier": 1.5,
  "updatedAt": "2026-02-18T12:00:00.000Z"
}