---
title: "List views for a Base"
method: GET
path: "/api/v1/bases/{baseId}/views"
tags: ["Views"]
---

# List views for a Base

`GET /api/v1/bases/{baseId}/views`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/bases/{baseId}/views`
- Auth: none declared

## Path parameters

- `baseId` string, required

## Query parameters

- `status` 'active' | 'archived': `active` (default) or the soft-archived set. Archived rows have the SAME shape as live ones — this is a predicate, not a different resource.

## Response `200`

Saved table views for a Base. `status=archived` returns the soft-deleted ones instead.

- object[]
  - `id` string, required
  - `baseId` string, required
  - `slug` string, required
  - `name` string, required
  - `description` string, required
  - `type` 'table' | 'gallery' | 'kanban' | 'calendar' | 'gantt', required
  - `config` object, required
    - `filters` object[]
      - `fieldSlug` string, required
      - `fieldId` string
      - `operator` 'contains' | 'equals' | 'not_empty' | 'is_empty' | 'is_true' | 'is_false', required
      - `value` unknown
    - `sorts` object[]
      - `direction` 'asc' | 'desc', required
      - `fieldSlug` string, required
      - `fieldId` string
    - `visibleFieldSlugs` string[]
    - `fieldWidths` object
    - `coverFieldSlug` string
    - `coverFit` 'cover' | 'fit'
    - `cardSize` 'small' | 'medium' | 'large'
    - `showFieldLabels` boolean
    - `stackByFieldSlug` string
    - `dateFieldSlug` string
    - `startFieldSlug` string
    - `endFieldSlug` string
    - `ganttScale` 'week' | 'month'
  - `status` 'active' | 'archived', required
  - `createdBy` string, required
  - `createdByUser` object
    - `id` string, required
    - `name` string, required
    - `email` string, required
    - `image` string, required
    - `role` string
  - `archivedAt` string, required
  - `createdAt` string, required
  - `updatedAt` string, required

---

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