---
title: "List markdown library items"
method: GET
path: "/api/markdowns"
tags: ["Markdowns"]
---

# List markdown library items

`GET /api/markdowns`

**Spaces method and path for this operation:**

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

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 parameters

- `page` number
- `per_page` number
- `query` string

## Response `200`

success

- object
  - `data` object[], required — List of markdown library items matching the query.
    - `data` object, required
      - `description` string — A short description of the markdown library item.
      - `title` string, required — The markdown library item title.
    - `id` string, required — The markdown library item ID.
    - `meta` KibanaHTTPAPIsKbnAsCodeMeta, required
      - `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, required
    - `page` number — The returned page of results.
    - `per_page` number — The number of results returned per page.
    - `total` number, required — The total number of results matching the query.

## Other responses

- `403` — forbidden

---

[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/versions/531c9e2a7d23/schema)