---
title: "Get Tenant Dashboards"
method: GET
path: "/spaces/dashboards"
tags: ["SPACES"]
---

# Get Tenant Dashboards

`GET /spaces/dashboards`

Get paginated dashboards from local database with advanced filtering and sorting.

This endpoint fetches dashboard metadata from the local database
that was previously synced from Metabase by the sync worker.

Args:
    page: Page number (starts from 1)
    page_size: Number of dashboards per page (max 100)
    search: Search term for dashboard name/description
    tags: Filter by specific tags
    collection_ids: Filter by collection IDs
    collection_names: Filter by collection names
    created_after: ISO date string - filter dashboards created after this date
    created_before: ISO date string - filter dashboards created before this date
    updated_after: ISO date string - filter dashboards updated after this date
    updated_before: ISO date string - filter dashboards updated before this date
    has_description: Filter dashboards with/without descriptions
    archived: Include/exclude archived dashboards
    sort_by: Sort by field: name, created_at, updated_at, collection_name
    sort_order: Sort order: asc, desc
    provider: Filter by engine ('metabase' or 'superset'); omit for both

Returns:
    dict: Contains the filtered, sorted, and paginated dashboards for the current tenant

## Query parameters

- `page` integer — Page number (starts from 1)
- `page_size` integer — Number of dashboards per page (max 100)
- `search` string, nullable — Search term for dashboard name/description
- `tags` string[], nullable — Filter by specific tags
- `collection_ids` integer[], nullable — Filter by collection IDs
- `collection_names` string[], nullable — Filter by collection names
- `created_after` string, nullable — ISO date string - filter dashboards created after this date
- `created_before` string, nullable — ISO date string - filter dashboards created before this date
- `updated_after` string, nullable — ISO date string - filter dashboards updated after this date
- `updated_before` string, nullable — ISO date string - filter dashboards updated before this date
- `has_description` boolean, nullable — Filter dashboards with/without descriptions
- `archived` boolean, nullable — Include/exclude archived dashboards
- `sort_by` string, nullable — Sort by field: name, created_at, updated_at, collection_name
- `sort_order` string, nullable — Sort order: asc, desc
- `provider` 'metabase' | 'superset', nullable — Filter by engine: 'metabase' or 'superset'

## Response `200`

Successful Response

- DashboardsResponse
  - `dashboards` MetabaseDashboard[], required
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `tags` string[], nullable
    - `attributes` object, nullable
    - `dashboard_id` integer, nullable
    - `embed_uuid` string, nullable
    - `provider` string
    - `collection_id` integer, nullable
    - `collection_name` string, nullable
    - `dashboard_metadata` object, nullable
    - `collection_metadata` object, nullable
    - `creator` Creator
      - `id` integer, nullable
      - `email` string, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `common_name` string, nullable
    - `view_count` integer, nullable
    - `last_viewed_at` string, nullable
    - `tenant_name` string, nullable
  - `count` integer, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required
  - `has_next` boolean, required
  - `has_previous` boolean, required
  - `available_tags` string[], nullable
  - `available_collections` CollectionOption[], nullable
    - `id` integer, required
    - `name` string, required
    - `count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/103580dad816/schema)