Sign in

v53

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

Get value list items

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/items/_find</span></div>

Refer to Spaces for more information.

Get all value list items in the specified list.

get/api/lists/items/_find

Query parameters

list_idstring nonempty required

Value list's identifier.

Example:21b01cfb-058d-44b9-838c-282be16c91cd

Parent value list's id to page through items for.

pageinteger
Example:1

The page number to return.

per_pageinteger
Example:20

The number of list items to return per page.

sort_fieldstring nonempty
Example:value

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

Returns the items that come after the last item 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 items are sorted and returned correctly.

Example:WzIwLFsiYjU3Yzc2MmMtMzAzNi00NjVjLTliZmItN2JmYjVlNmU1MTVhIl1d

Opaque cursor returned in a previous response; pass it to continue listing from the next page. Omit on the first request.

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

Returns the items that come after the last item 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 items are sorted and returned correctly.

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": "54b01cfb-058d-44b9-838c-282be16c91cd",
      "list_id": "21b01cfb-058d-44b9-838c-282be16c91cd",
      "tie_breaker_id": "f5508188-b1e9-4e6e-9662-d039a7d89899",
      "updated_at": "2025-01-08T04:47:34.273Z",
      "updated_by": "elastic"
    }
  ]
}