List templates

Return the saved templates in a project, newest first. Cursor-paginated like every list endpoint. GET /v1/templates Results are scoped to the project resolved from your key (or the X-Drin-Product header for account-wide keys).

Query parameters

integer

Page size, 1–100. Defaults server-side.

string

The nextCursor from a previous response. Omit for the first page; when nextCursor is null you’ve reached the end. See Pagination.

Request

curl "https://api.drin.run/v1/templates?limit=20" \
  -H "Authorization: Bearer $DRIN_API_KEY"

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

const { data, nextCursor } = await drin.templates.list({ limit: 20 });

// Or walk every page with the async iterator:
for await (const template of drin.templates.paginate()) {
  console.log(template.slug, template.name);
}

Response

A cursor page of template objects.

200 OK

{
  "data": [
    {
      "id": "tmpl_8XQ2k9",
      "slug": "order-receipt",
      "name": "Order Receipt",
      "subject": "Receipt {{orderId}}",
      "html": "<p>Hi {{firstName}}, thanks for your order.</p>",
      "text": null,
      "variables": ["firstName", "orderId"],
      "createdAt": "2026-06-02T10:00:00.000Z",
      "updatedAt": "2026-06-02T10:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

List templates

Query parameters

Request

Response

​Query parameters

​Request

​Response

Query parameters

Request

Response