---
title: "GET /api/search"
method: GET
path: "/api/search"
tags: ["/api/search"]
---

# GET /api/search

`GET /api/search`

Search for items in Metabase.
  For the list of supported models, check [[metabase.search.config/all-models]].

  Filters:
  - `archived`: set to true to search archived items only, default is false
  - `table_db_id`: search for tables, cards, and models of a certain DB
  - `models`: only search for items of specific models. If not provided, search for all models
  - `filters_items_in_personal_collection`: only search for items in personal collections
  - `created_at`: search for items created at a specific timestamp
  - `created_by`: search for items created by a specific user
  - `last_edited_at`: search for items last edited at a specific timestamp
  - `last_edited_by`: search for items last edited by a specific user
  - `search_native_query`: set to true to search the content of native queries
  - `verified`: set to true to search for verified items only (requires Content Management or Official Collections premium feature)
  - `ids`: search for items with those ids, works iff single value passed to `models`
  - `display_type`: search for cards/models with specific display types
  - `non_temporal_dim_ids`: search for cards/metrics/datasets with this exact set of non temporal dimension field IDs (requires appdb engine)
  - `has_temporal_dim`: set to true for cards/metrics/datasets with 1 or more temporal dimensions (requires appdb engine)

  Note that not all item types support all filters, and the results will include only models that support the provided
  filters. For example:

  - The `created-by` filter supports dashboards, models, actions, and cards.
  - The `verified` filter supports models and cards.

  A search query that has both filters applied will only return models and cards.

## Query parameters

- `q` string, nullable
- `context` string, nullable
- `archived` boolean, nullable, required
- `collection` integer, nullable — value must be an integer greater than zero.
- `table_db_id` integer, nullable — value must be an integer greater than zero.
- `models` string[], nullable
- `filter_items_in_personal_collection` 'all' | 'only' | 'only-mine' | 'exclude' | 'exclude-others', nullable
- `created_at` string, nullable
- `created_by` integer[], nullable
- `display_type` string[], nullable
- `last_edited_at` string, nullable
- `last_edited_by` integer[], nullable
- `model_ancestors` boolean, nullable, required
- `search_engine` string, nullable
- `search_native_query` boolean, nullable
- `verified` boolean, nullable
- `ids` integer[], nullable
- `calculate_available_models` boolean, nullable
- `include_dashboard_questions` boolean, nullable, required
- `include_metadata` boolean, nullable, required
- `non_temporal_dim_ids` string, nullable
- `has_temporal_dim` boolean, nullable

## 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/revisions/08b5a2bafb4f/schema)