---
title: "List templates in a data source"
method: GET
path: "/v1/data_sources/{data_source_id}/templates"
tags: ["Data sources"]
---

# List templates in a data source

`GET /v1/data_sources/{data_source_id}/templates`

## Path parameters

- `data_source_id` string, required

## 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

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- object
  - `templates` object[], required — Array of templates available in this data source.
    - `id` string, uuid, required
    - `name` string, required — Name of the template.
    - `is_default` boolean, required — Whether this template is the default template for the data source.
  - `has_more` boolean, required — Whether there are more templates available beyond this page.
  - `next_cursor` string, uuid, required

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

## Changes

- **2026-08-15** `c90a4587bc95` — 1 warning
  - added the new `idempotency_key_reused` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
- **2026-08-13** `ae20477af71b` — 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3` to the response body `oneOf` list for the response status `403`
  - removed `#/components/schemas/publicApiCommonErrorResponse, subschema #2` from the response body `allOf` list for the response status `403`
- **2026-08-12** `28d140865fc6` — 2 warning
  - added the new `agent_credit_limit_reached` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
  - added the new `workspace_credits_exhausted` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
- **2026-07-31** `301eea0116d9` — 2 warning
  - added the new `invalid_beta` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
  - added the new `invalid_credit_limit` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
- …earlier changes not shown

[Full history](https://skmtc.dev/notion/apis/notion-api/changes/v1/data_sources/:data_source_id/templates/get.md)

---

[API](https://skmtc.dev/notion/apis/notion-api.md) · [All operations](https://skmtc.dev/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/d125dfa2cde5/schema)