---
type: api
title: Get a metadata list
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-getendpointmetadatalist
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/kibana/v8/operation/operation-getendpointmetadatalist
products:
  - Kibana
---

# Get a metadata list

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

## Paths

- `GET` `/api/endpoint/metadata`
- `GET` `/s/{space_id}/api/endpoint/metadata`

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

## Description

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

## Query String Parameters

- `page` (integer · min: 1 · default: 1)
- `pageSize` (integer · min: 1 · max: 100 · default: 10)
- `kuery` (string)
- `hostStatuses` ([] object)
  Values: `healthy`, `offline`, `updating`, `inactive`, `unenrolled`
- `sortField` (enum)
  Values: `enrolled_at`, `metadata.host.hostname`, `host_status`, `metadata.Endpoint.policy.applied.name`, `metadata.Endpoint.policy.applied.status`, `metadata.host.os.name`, `metadata.host.ip`, `metadata.agent.version`, `last_checkin`
- `sortDirection` (enum)
  Values: `asc`, `desc`

## Response

OK

`application/json`

Type: `object`

## Code Examples

#### Console

```console
GET /api/endpoint/metadata?hostStatuses={hostStatuses}
```

#### curl

```curl
curl -X GET "https://{kibana_url}/api/endpoint/metadata?hostStatuses={hostStatuses}"
```