Join us for our Developer Platform Hackathon, May 16-17. Apply now →
import { Client } from "@notionhq/client"
const notion = new Client({ auth: process.env.NOTION_API_KEY })
const response = await notion.views.list({
database_id: "248104cd-477e-80fd-b757-e945d38000bd"
}){
"object": "<string>",
"next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"has_more": true,
"results": [
{
"object": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"type": "<string>",
"view": {},
"request_status": {
"incomplete_reason": "<string>"
}
}List views
List all views in a database.
import { Client } from "@notionhq/client"
const notion = new Client({ auth: process.env.NOTION_API_KEY })
const response = await notion.views.list({
database_id: "248104cd-477e-80fd-b757-e945d38000bd"
}){
"object": "<string>",
"next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"has_more": true,
"results": [
{
"object": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"type": "<string>",
"view": {},
"request_status": {
"incomplete_reason": "<string>"
}
}Returns a paginated list of View references for the specified database.Documentation Index
Fetch the complete documentation index at: https://developers.notion.com/llms.txt
Use this file to discover all available pages before exploring further.
Errors
Returns a 404 HTTP response if the database doesn’t exist, or if the connection doesn’t have access. Returns a 400 or 429 HTTP response if the request exceeds the request limits.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 Query Parameters
ID of a Notion database (collection view block) to list views for. At least one of database_id or data_source_id is required.
ID of a data source (collection) to list all views for, including linked views across the workspace. At least one of database_id or data_source_id is required.
If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.
The number of items from the full list desired in the response. Maximum: 100
1 <= x <= 100