Get view query results

Paginate through cached view query results.

GET /v1/views/{view_id}/queries/{query_id}

TypeScript SDK

JavaScript

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.views.queries.results({
  view_id: "a3f1b2c4-5678-4def-abcd-1234567890ab",
  query_id: "b4e2c3d5-6789-4abc-def0-1234567890cd"
})

200

{
  "object": "<string>",
  "next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "has_more": true,
  "results": [
    {
      "object": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "type": "<string>",
  "page": {},
  "request_status": {
    "incomplete_reason": "<string>"
  }
}

Returns a page of results from a previously created view query. Use start_cursor and page_size to paginate through the cached result set.

Cached results expire after 15 minutes from the time the query was created. If the cache has expired, this endpoint returns a 404.

Connection capabilities

This endpoint requires a connection to have read content capabilities. For more information on connection capabilities, see the capabilities guide.

Truncated queries

If the underlying view query matched more rows than the server-side pagination limit, the response will include a request_status field:

{
  "object": "list",
  "type": "page",
  "results": [...],
  "next_cursor": null,
  "has_more": false,
  "request_status": {
    "type": "incomplete",
    "incomplete_reason": "query_result_limit_reached"
  }
}

The request_status field is surfaced on every page of paginated results for a truncated query, so your connection can detect it regardless of which page it is on. When this field is present, there are additional rows matching the view’s configuration that are not returned.

See Create a view query for guidance on working around the pagination limit (narrower view filters, connection webhooks).

Errors

Returns a 404 HTTP response if the query doesn’t exist, has expired, or the view_id doesn’t match.

Returns a 400 or 429 HTTP response if the request exceeds the request limits.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version · enum<string> · required

The API version to use for this request. The latest version is 2026-03-11.

Available options: 2026-03-11

Path Parameters

view_id · string · required

The ID of the view.

query_id · string · required

The ID of the query.

Query Parameters

start_cursor · string

If supplied, this endpoint will return a page of results starting after the cursor provided.

page_size · integer

The number of results to return per page. Maximum: 100

Required range: 1 <= x <= 100

Response

200

application/json

object · string · required

Always list

Allowed value: "list"

next_cursor · string<uuid> | null · required

has_more · boolean · required

results · object[] · required

Show child attributes

type · string · required

Always page

Allowed value: "page"

page · object · required

request_status · object

Show child attributes