Views

Create a view query

Changed on
post/v1/views/{view_id}/queries

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/views/{view_id}/queries
  • Auth
    HTTP bearer

Path parameters

view_idstring required

Headers

Notion-Version'2026-03-11' required

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

Request body

page_sizeinteger

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

Response

object'view_query' required

The object type.

idstring uuid required
view_idstring uuid required
expires_atstring date-time required

When the cached query results expire.

total_countnumber required

Total number of results in the query.

next_cursorstring uuid required
has_moreboolean required

Whether there are more results.

Changes

  • c90a4587bc95Revision changes
    • warning

      added the new idempotency_key_reused enum value to the / response property for the response status

  • ae20477af71bRevision changes
    • breaking

      added subschema #1 subschema #2 subschema #3 to the response body oneOf list for the response status

    • info

      removed subschema #2 from the response body allOf list for the response status