---
title: "GET /api/collection/root/items/metadata"
method: GET
path: "/api/collection/root/items/metadata"
tags: ["/api/collection"]
---

# GET /api/collection/root/items/metadata

`GET /api/collection/root/items/metadata`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/collection/root/items/metadata`
- Auth: API key in header `X-API-Key`

Metadata about the Root Collection's items list: the models with at least one visible item plus the item count.
  Unlike `GET /api/collection/root/items`, the result does not depend on search text; pass that endpoint's other
  scope params so the metadata describes the list being shown.

## Query parameters

- `models` string[], nullable
- `archived` boolean, nullable: value must be a valid boolean string ('true' or 'false').
- `namespace` string, nullable: value must be a non-blank string.
- `pinned-state` 'is_not_pinned' | 'is_pinned' | 'all', nullable
- `collection-type` 'remote-synced'
- `include-library` boolean, nullable: value must be a valid boolean string ('true' or 'false').
- `show-dashboard-questions` boolean, nullable: value must be a valid boolean string ('true' or 'false').
- `show-exploration-documents` boolean, nullable: value must be a valid boolean string ('true' or 'false').

## Response `2XX`

Successful response

- MetabaseCollectionsRestApiItemsMetadata
  - `available_models` string[], required
  - `total_items` integer, required: value must be an integer greater or equal to than zero.

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/collection/root/items/metadata/get.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)