v1

latestOpenAPI 3.1.02026-07-2664485505.4 KB
Data sources

Query a data source

post/v1/data_sources/{data_source_id}/query

Path parameters

data_source_idstring required

Query parameters

filter_propertiesstring[]

Headers

Notion-Version'2026-03-11' required

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

Request body

start_cursorstring
page_sizenumber
is_archivedboolean

Whether to return archived pages. When omitted or false, returns non-archived pages. When true, returns archived pages.

result_type'page' | 'data_source'

Optionally filter the results to only include pages or data sources. Regular, non-wiki databases only support page children. The default behavior is no result type filtering, in other words, returning both pages and data sources for wikis.

Response

type'page_or_data_source' required
page_or_data_sourceEmptyObject required
object'list' required
next_cursorstring nullable required
has_moreboolean required

Example response

{
  "results": [
    {
      "icon": {
        "icon": {
          "name": "pizza"
        }
      }
    }
  ]
}