Web API

Press shift + S to search API reference.

Views

List views

gethttps://api.airtable.com/v0/meta/bases/{baseId}/views

Lists basic information of base views.

Requirements

AuthenticationPersonal access token, OAuth integration
ScopeworkspacesAndBases:read
User role

Base read-only

Billing plansEnterprise (pre-2023.08 legacy plan), Enterprise Scale

Path parameters

baseId
string

Query parameters

include
optional<array of "visibleFieldIds">

If specified, additional fields to include in the views object response; currently, this list only allows a single literal value visibleFieldIds (for views of type grid only)

Response format

views
array of the below object
id
string
type
"grid" | "form" | "calendar" | "gallery" | "kanban" | "timeline" | "block"

Gantt views have a type of 'block'

personalForUserId
optional<string>

Present if the view is personal for a user.

name
string
visibleFieldIds
optional<array of strings>

Available on grid views only: list of visible (non-hidden) field IDs, when requested with include query paremeter

Request (example)
Copy
$
curl "https://api.airtable.com/v0/meta/bases/{baseId}/views" \
-H "Authorization: Bearer YOUR_TOKEN"
200 – Response (example)
{
"views": [
{
"id": "viwQpsuEDqHFqegkp",
"name": "My Grid View",
"personalForUserId": "usrL2PNC5o3H4lBEi",
"type": "grid"
},
{
"id": "viwi3KXvrKug2mIBS",
"name": "Project Plan (Gantt Chart)",
"type": "block"
}
]
}