Sign in

v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
Security Lists API

Get value lists

Spaces method and path for this operation:

<div><span class="operation-verb get">get</span>&nbsp;<span class="operation-path">/s/{space_id}/api/lists/_find</span></div>

Refer to Spaces for more information.

Get a paginated subset of value lists. By default, the first page is returned, with 20 results per page.

get/api/lists/_find

Query parameters

pageinteger
Example:1

The page number to return.

per_pageinteger
Example:20

The number of value lists to return per page.

sort_fieldstring nonempty
Example:name

Determines which field is used to sort the results.

sort_order'desc' | 'asc'
Example:asc

Determines the sort order, which can be desc or asc

cursorstring nonempty
Example:WzIwLFsiYjU3Yzc2MmMtMzAzNi00NjVjLTliZmItN2JmYjVlNmU1MTVhIl1d

Returns the lists that come after the last lists returned in the previous call (use the cursor value returned in the previous call). This parameter uses the tie_breaker_id field to ensure all lists are sorted and returned correctly.

filterstring
Example:value:127.0.0.1

Filters the returned results according to the value of the specified field, using the <field name>:<field value> syntax.

Response

Successful response

cursorstring nonempty required
pageinteger required
per_pageinteger required
totalinteger required

Example response

{
  "cursor": "WzIwLFsiYjU3Yzc2MmMtMzAzNi00NjVjLTliZmItN2JmYjVlNmU1MTVhIl1d",
  "data": [
    {
      "_version": "WzIsMV0=",
      "@timestamp": "2025-01-08T04:47:34.273Z",
      "created_at": "2025-01-08T04:47:34.273Z",
      "created_by": "elastic",
      "id": "21b01cfb-058d-44b9-838c-282be16c91cd",
      "name": "List of bad IPs",
      "tie_breaker_id": "f5508188-b1e9-4e6e-9662-d039a7d89899",
      "updated_at": "2025-01-08T04:47:34.273Z",
      "updated_by": "elastic",
      "version": 1
    }
  ]
}