---
title: "List views"
method: GET
path: "/api/v3/meta/bases/{baseId}/tables/{tableId}/views"
tags: ["Views"]
---

# List views

`GET /api/v3/meta/bases/{baseId}/tables/{tableId}/views`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/bases/{baseId}/tables/{tableId}/views`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/bases/:baseId/tables/:tableId/views/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of all views for a specific table.

**Note**: View APIs are available on cloud-hosted **Enterprise** plans, and on licensed self-hosted deployments (**Business** plan and above).

## Path parameters

- `baseId` string, required
- `tableId` string, required

## Response `200`

List of views retrieved successfully.

- ViewList
  - `list` object[], required
    - `id` string, required: Unique identifier for the view.
    - `table_id` string: Id of table associated with the view.
    - `title` string, required: Title of the view.
    - `description` string, nullable: Description of the view.
    - `type` 'grid' | 'gallery' | 'kanban' | 'calendar' | 'form' | 'map' | 'timeline' | 'gantt', required: Type of the view.
    - `lock_type` 'collaborative' | 'locked' | 'personal', required: View configuration edit state.
    - `created_by` string, required: User ID of the creator.
    - `owned_by` string: User ID of the owner. Applicable only for personal views.
    - `created_at` string, date-time, required: Timestamp of creation.
    - `updated_at` string, date-time, required: Timestamp of last update.

## Other responses

- `404`: Table not found.
- `500`: Server error.

## Changes

- **2026-10-13** `2ba4267a99d7`: 2 warning
  - added the new `gantt` enum value to the `list/items/type` response property for the response status `200`
  - added the new `timeline` enum value to the `list/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/bases/:baseId/tables/:tableId/views/get.md)

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)