---
title: "Create a view query"
method: POST
path: "/v1/views/{view_id}/queries"
tags: ["Views"]
---

# Create a view query

`POST /v1/views/{view_id}/queries`

## Path parameters

- `view_id` string, required

## Headers

- `Notion-Version` '2026-03-11', required

## Request body

- CreateViewQueryRequest
  - `page_size` integer — The number of results to return per page. Maximum: 100

## Response `200`

- ViewQueryResponse
  - `object` 'view_query', required — The object type.
  - `id` string, uuid, required
  - `view_id` string, uuid, required
  - `expires_at` string, date-time, required — When the cached query results expire.
  - `total_count` number, required — Total number of results in the query.
  - `results` PageReferenceResponse[], required — The page results for this page.
    - `object` string, required — The object type.
    - `id` string, uuid, required
  - `next_cursor` string, uuid, required
  - `has_more` boolean, required — Whether there are more results.
  - `request_status` RequestStatusResponse
    - `type` 'complete' | 'incomplete', required — Whether the result set is complete or incomplete. `incomplete` means the response does not include all rows that match the query parameters (e.g. due to a server-side pagination depth limit).
    - `incomplete_reason` 'query_result_limit_reached' — Why the result set is incomplete. Only present when `type` is `incomplete`.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/versions/551da43bb186/schema)