Notion/queryDataSource

Online calls unavailable · details below

NotionNotion collaborative workspace API

POST/v1/data_sources/{data_source_id}/query

Query a data source

Queries entries (pages) in a data source with filters, sorts, and pagination.

Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.

Request

operationId: queryDataSource
Server: https://api.notion.com
Authentication: bearerAuth, basicAuth

Request parameters

`data_source_id`

pathidRequestrequired

`filter_properties`

queryarray

Return values only for the listed properties.

`Notion-Version`

headerstringrequired

API version date for the request; the current latest version is 2026-03-11.

2026-03-11

Request body

objectrequired

Properties: filteris_archivedpage_sizeresult_typesortsstart_cursor

Responses

`200`

objectapplication/json

Request succeeded.

Properties: has_morenext_cursorobjectpage_or_data_sourcerequest_statusresultstype

`400`

error_api_400application/json

Request parameters are invalid.

`401`

error_api_401application/json

Unauthenticated or the token is invalid.

`403`

error_api_403application/json

Access to the resource is forbidden.

`404`

error_api_404application/json

The requested resource was not found.

`406`

error_api_406application/json

The request cannot be represented as requested.

`409`

error_api_409application/json

The request conflicts with the current state of the resource.

`429`

error_api_429application/json

Rate limited; retry after Retry-After.

`500`

error_api_500application/json

Upstream internal error.

`503`

error_api_503application/json

Upstream service temporarily unavailable.

`504`

error_api_504application/json

Upstream gateway timeout.

`529`

error_api_529application/json

Upstream overloaded; retry like a 429.

{
  "has_more": true,
  "next_cursor": "example content",
  "object": "list",
  "page_or_data_source": {},
  "request_status": {
    "incomplete_reason": "query_result_limit_reached",
    "type": "complete"
  },
  "results": [],
  "type": "page_or_data_source"
}