---
title: "GET /v1/mailboxes/{mailboxId}/templates"
method: GET
path: "/v1/mailboxes/{mailboxId}/templates"
---

# GET /v1/mailboxes/{mailboxId}/templates

`GET /v1/mailboxes/{mailboxId}/templates`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `/authorize`, token URL `/oauth/token`, scopes: `email.read`)
  - HTTP bearer

This mailbox's templates, newest first, a page at a time — summaries without their bodies; `getTemplate` answers one whole. `limit` defaults to 100.

## Path parameters

- `mailboxId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

The request has succeeded.

- object: `{ data, nextCursor }` — the one envelope every paged collection answers with. The cursor is opaque and ours to change; a caller must never construct one. **`nextCursor` is non-null exactly when the page came back full** — so a full final page hands out a cursor whose next page is empty, which is correct and cheaper than over-fetching by one row to find out. A cursor the server cannot read answers 400 rather than silently restarting: a client looping "fetch, follow nextCursor" against a cursor that quietly reset would loop over page one forever.
  - `data` TemplateSummary[], required
    - `id` string, required
    - `name` string, required
    - `subject` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `nextCursor` string, nullable, required: Opaque. Non-null exactly when this page was full; `null` otherwise.

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `default`: An unexpected error response.

---

[API](https://skmtc.dev/foundermail/apis/mailbox.md) - [All operations](https://skmtc.dev/foundermail/apis/mailbox/llms.txt) - [OpenAPI document](https://skmtc.dev/foundermail/apis/mailbox/revisions/6a50628a86ed?raw)