---
title: "Get value list privileges"
method: GET
path: "/api/lists/privileges"
tags: ["Security Lists API"]
---

# Get value list privileges

`GET /api/lists/privileges`

**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/privileges</span></div>

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Returns the caller's authentication state and the Elasticsearch `cluster`, `index`, and `application`
privileges for `.lists` and `.items` data streams in the current Kibana space. Use this to decide which list
APIs (`read` vs `all` operations) are available before you create or import lists.

## Response `200`

Successful response

- object
  - `is_authenticated` boolean, required
  - `listItems` SecurityListsAPIListItemPrivileges, required
    - `application` object, required
    - `cluster` object, required
    - `has_all_requested` boolean, required
    - `index` object, required
    - `username` string, required
  - `lists` SecurityListsAPIListPrivileges, required
    - `application` object, required
    - `cluster` object, required
    - `has_all_requested` boolean, required
    - `index` object, required
    - `username` string, required

## Other responses

- `400` — Invalid input data response
- `401` — Unsuccessful authentication response
- `403` — Not enough privileges response
- `500` — Internal server error response

---

[API](https://skmtc.net/elastic/apis/kibana-apis.md) · [All operations](https://skmtc.net/elastic/apis/kibana-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/kibana-apis/revisions/deb2e8b751e7/schema)