---
title: "List links library items"
method: GET
path: "/api/links"
tags: ["Links"]
---

# List links library items

`GET /api/links`

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

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

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

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

## Query parameters

- `page` number
- `per_page` number
- `query` string
- `tags` string[] — Tag IDs associated with this dashboard.
- `excluded_tags` string[] — Tag IDs associated with this dashboard.
- `tag_names` string[]
- `excluded_tag_names` string[]

## Response `200`

success

- object
  - `data` object[], required — List of links library items matching the query.
    - `data` object, required
      - `description` string — A short description of the links library item.
      - `title` string, required — The links library item title.
    - `id` string, required
    - `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)