List data source templates

Use this API to retrieve details of all page templates available for a data source.

GET /v1/data_sources/{data_source_id}/templates

TypeScript SDK

JavaScript

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.dataSources.listTemplates({
  data_source_id: "d9824bdc-8445-4327-be8b-5b47500af6ce"
})

curl --request GET \
  --url https://api.notion.com/v1/data_sources/{data_source_id}/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Notion-Version: <notion-version>'

import requests

url = "https://api.notion.com/v1/data_sources/{data_source_id}/templates"

headers = {
    "Notion-Version": "<notion-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.notion.com/v1/data_sources/{data_source_id}/templates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Notion-Version: <notion-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notion.com/v1/data_sources/{data_source_id}/templates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Notion-Version", "<notion-version>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.notion.com/v1/data_sources/{data_source_id}/templates")
  .header("Notion-Version", "<notion-version>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.notion.com/v1/data_sources/{data_source_id}/templates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Notion-Version"] = '<notion-version>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "templates": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "is_default": true
    }
  ],
  "has_more": true,
  "next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "unauthorized",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "restricted_resource",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "row_limit_exceeded",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "conflict_error",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "rate_limited",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "internal_server_error",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "service_unavailable",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "gateway_timeout",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "service_overload",
  "status": "<unknown>",
  "additional_data": {}
}

The response contains a templates array with up to 100 results per page. Each template has the following fields:

Field	Type	Description
id	string (UUIDv4)	The template ID.
name	string	The template’s display name.
is_default	boolean	Whether the template is the data source’s default.

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.

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 to get a template’s properties and 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

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version · enum<string> · required

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

Available options: 2026-03-11

Path Parameters

data_source_id · string · required

ID of a Notion data source.

Query Parameters

name · string

Filter templates by name (case-insensitive substring match).

start_cursor · string

If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.

page_size · integer

The number of items from the full list desired in the response. Maximum: 100

Required range: 1 <= x <= 100

Response

200

application/json

templates · object[] · required

Array of templates available in this data source.

Maximum array length: 100

Show child attributes

has_more · boolean · required

Whether there are more templates available beyond this page.

next_cursor · string<uuid> | null · required

Cursor to use for the next page of results. Null if there are no more results.