---
type: api
title: List markdown library items
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/operation/operation-get-markdowns
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/operation/operation-get-markdowns
products:
  - Kibana
---

# List markdown library items

Availability: Planned

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/markdowns`
- `GET` `/s/{space_id}/api/markdowns`

- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/kibana/authentication#apikeyauth)
- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/kibana/authentication#basicauth)

## Description

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

Returns a paginated list of markdown library items. Each result includes title, description, and metadata, but not the content. Use `GET /api/markdowns/{id}` to retrieve the complete state.

## Query String Parameters

- `page` (number · min: 1 · default: 1)
  The page of results to return.
- `per_page` (number · min: 1 · max: 1000 · default: 20)
  The number of results to return per page.
- `query` (string)
  Filters results by `title` and `description` using Elasticsearch [`simple_query_string`](https://www.elastic.co/docs/reference/query-languages/query-dsl/query-dsl-simple-query-string-query) syntax. Multi-word terms require all words to match.

## Responses

#### `200`

success

`application/json`

- `data` ([] object · min: 0 · max: 1000)
  List of markdown library items matching the query.
  - `data` (object)
    - `description` (string)
      A short description of the markdown library item.
    - `title` (string)
      The markdown library item title.
  - `id` (string)
    The markdown library item ID.
  - `meta` ({})
    - `created_at` (string)
      Timestamp when the object was created (ISO 8601).
    - `created_by` (string)
      User profile ID of the user who created the object.
    - `managed` (boolean)
      When `true`, the object is managed by Kibana and cannot be edited by users.
    - `owner` (string)
      Identifier of the plugin or team that owns this object.
    - `updated_at` (string)
      Timestamp when the object was last updated (ISO 8601).
    - `updated_by` (string)
      User profile ID of the user who last updated the object.
    - `version` (string)
      Internal version identifier for optimistic concurrency control.
- `meta` (object)
  - `page` (number · min: 1 · default: 1)
    The returned page of results.
  - `per_page` (number · min: 1 · max: 1000 · default: 20)
    The number of results returned per page.
  - `total` (number)
    The total number of results matching the query.
#### `403`

forbidden

## Code Examples

#### Console

```console
GET kbn:/api/markdowns?query=welcome&per_page=10
```

#### curl

```curl
curl -X GET "${KIBANA_URL}/api/markdowns?query=welcome&per_page=10" \
  -H "Authorization: ApiKey ${API_KEY}"
```

## Response Examples

#### Search markdown library items response

Paginated list of markdown library item summaries. Each item includes the ID, a subset of state fields (`title` and `description`), and metadata. The full `content` is not included; use `GET /api/markdowns/{id}` to retrieve a specific item.

```json
{
  "data": [
    {
      "data": {
        "description": "Intro and context for the web logs dashboard.",
        "title": "Web logs overview"
      },
      "id": "5e1f3a20-c4d6-11ef-be8b-3c7c2b9d1f4e",
      "meta": {
        "created_at": "2026-04-13T10:00:00.000Z",
        "managed": false,
        "updated_at": "2026-04-13T10:00:00.000Z",
        "version": "WzU5LDFd"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1
  }
}
```