---
title: "Search Discover sessions"
method: GET
path: "/api/discover_sessions"
tags: ["Discover sessions"]
---

# Search Discover sessions

`GET /api/discover_sessions`

## Request

- Base URL: `https://localhost:5601`
- URL: `https://localhost:5601/api/discover_sessions`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP basic

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

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

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

Returns a paginated summary list of Discover sessions. Use `GET /api/discover_sessions/{id}` for the full session state.

## Query parameters

- `page` number
- `per_page` number
- `query` string
- `tags` string[]: Tag IDs to include.
- `excluded_tags` string[]: Tag IDs to exclude.
- `tag_names` string[]
- `excluded_tag_names` string[]

## Response `200`

Success

- object
  - `data` object[], required: List of matching Discover sessions (summaries, not the full session state).
    - `data` object, required
      - `description` string: Discover session description.
      - `tags` string[]: Tag IDs associated with this Discover session.
      - `title` string, required: Discover session title.
    - `id` string, required: The Discover session 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

- `400`: Invalid request
- `500`: Internal server error

---

[API](https://skmtc.dev/elastic/apis/kibana-apis.md) - [All operations](https://skmtc.dev/elastic/apis/kibana-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/elastic/apis/kibana-apis/revisions/b87131d80c52?raw)