---
title: "GET /api/collection/{id}/items"
method: GET
path: "/api/collection/{id}/items"
tags: ["/api/collection"]
---

# GET /api/collection/{id}/items

`GET /api/collection/{id}/items`

Fetch a specific Collection's items with the following options:

  *  `models` - only include objects of a specific set of `models`. If unspecified, returns objects of all models
  *  `archived` - when `true`, return archived objects *instead* of unarchived ones. Defaults to `false`.
  *  `pinned_state` - when `is_pinned`, return pinned objects only.
                   when `is_not_pinned`, return non pinned objects only.
                   when `all`, return everything. By default returns everything.
  *  `include_can_run_adhoc_query` - when this is true hydrates the `can_run_adhoc_query` flag on card models

  Note that this endpoint should return results in a similar shape to `/api/dashboard/:id/items`, so if this is
  changed, that should too.

## Path parameters

- `id` union, required
  - integer — value must be an integer greater than zero.
  - string — String must be a valid 21-character NanoID string.

## Query parameters

- `models` string[], nullable
- `archived` boolean, nullable, required
- `include_can_run_adhoc_query` boolean, nullable, required
- `pinned_state` 'is_not_pinned' | 'is_pinned' | 'all', nullable
- `sort_column` 'model' | 'name' | 'last_edited_by' | 'last_edited_at' | 'description', nullable
- `sort_direction` 'desc' | 'asc', nullable
- `official_collections_first` boolean, nullable
- `show_dashboard_questions` boolean, nullable, required

## Response `2XX`

Successful response

## Other responses

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

---

[API](https://skmtc.net/metabase/apis/metabase-api.md) · [All operations](https://skmtc.net/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metabase/metabase-api/versions/08b5a2bafb4f/schema)