Data sources
List data source templates
List the page templates your connection can read in a data source.
GET
TypeScript SDK
The response contains a
templates array with up to 100 results per page. To filter by name, pass all or part of a template name in the name query parameter. Matching ignores case.
Pagination
If more templates are available,has_more is true and next_cursor contains the cursor for the next page. Pass that value as start_cursor in the next request.
In the JavaScript SDK v5.3.0 or later, use iterateDataSourceTemplates to follow the cursors. The example reads your token from NOTION_API_KEY and the data source ID from NOTION_DATA_SOURCE_ID.
Permissions
This endpoint returns only templates under the specified data source that the connection can access. Sharing the parent database with the connection generally grants access to its child templates. Templates are also Notion pages. Use Retrieve a page for its properties or Retrieve a page as markdown for its content. You can also open a template in Notion and copy its URL to find its ID.Errors
Returns a 404 HTTP response if the data source doesn’t exist or if the connection doesn’t have access to it. Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.Authorizations
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11