GET/v1/templates

List Templates

Get all available templates with their metadata.

Get all available templates with their metadata. Templates control the visual appearance of published documents: typography, colors, spacing, and element styles.

This endpoint does not count toward your monthly usage quota.

Query Parameters

Parameter	Type	Required	Description
`category`	`string`		Filter by category. Options: `free`, `business`, `academic`, `developer`, `creative`, `dark`, `productivity`, `special`

Response

Returns an array of template objects.

Field	Type	Description
`data`	`array`	Array of template objects
`data[].id`	`string`	Template ID used in API calls
`data[].name`	`string`	Human-readable template name
`data[].category`	`string`	Template category
`data[].description`	`string`	Brief description of the template style
`total`	`number`	Total number of templates returned

Template Categories

Category	Count	Tier
`free`	8	Free
`business`	8	Pro
`academic`	7	Pro
`developer`	10	Pro
`creative`	10	Pro
`dark`	6	Pro
`productivity`	8	Pro
`special`	6	Pro

NOTE

Free tier accounts can use any of the 8 free templates. Pro templates are available to Pro subscribers. See the full Template Catalog for all 63 templates with descriptions.

# List all templates
curl https://api.unmarkdown.com/v1/templates \
  -H "Authorization: Bearer um_your_key"

# Filter by category
curl "https://api.unmarkdown.com/v1/templates?category=developer" \
  -H "Authorization: Bearer um_your_key"

const res = await fetch('https://api.unmarkdown.com/v1/templates', {
  headers: {
    'Authorization': 'Bearer um_your_key'
  }
});
const data = await res.json();
console.log(`${data.total} templates available`);

// Filter by category
const devRes = await fetch(
  'https://api.unmarkdown.com/v1/templates?category=developer',
  { headers: { 'Authorization': 'Bearer um_your_key' } }
);

import requests

res = requests.get(
    'https://api.unmarkdown.com/v1/templates',
    headers={'Authorization': 'Bearer um_your_key'}
)
data = res.json()
print(f"{data['total']} templates available")

# Filter by category
res = requests.get(
    'https://api.unmarkdown.com/v1/templates',
    headers={'Authorization': 'Bearer um_your_key'},
    params={'category': 'developer'}
)

Response

{
  "data": [
    {
      "id": "swiss",
      "name": "Swiss",
      "category": "free",
      "description": "Clean, precise, and modern. Inspired by Swiss design principles."
    },
    {
      "id": "dracula",
      "name": "Dracula",
      "category": "developer",
      "description": "The iconic dark theme. Purple accents on a cool blue-gray canvas."
    },
    {
      "id": "executive",
      "name": "Executive",
      "category": "business",
      "description": "Navy headings, gold accents. Board-room polished."
    }
  ],
  "total": 63
}

Filtered by category

{
  "data": [
    {
      "id": "dracula",
      "name": "Dracula",
      "category": "developer",
      "description": "The iconic dark theme. Purple accents on a cool blue-gray canvas."
    },
    {
      "id": "nord",
      "name": "Nord",
      "category": "developer",
      "description": "Arctic, north-bluish palette. Clean and calm with frost-blue accents."
    }
  ],
  "total": 10
}

Claim Demo Document

Get Usage