---
title: "List the shipped design templates"
method: GET
path: "/v1/templates"
tags: ["Templates"]
---

# List the shipped design templates

`GET /v1/templates`

## Request

- Base URL: `https://electronics-architect.com`
- URL: `https://electronics-architect.com/v1/templates`
- Auth: HTTP bearer

Scope: `read`. The same starting points the editor offers on first run: each template's id, its sheet names, a component census by node type, and the explanatory notes it carries on canvas. Start here when the user describes a design that probably already exists (an FPGA rail set, a USB-C PD supply, a motor driver). Static files shipped with the build; `Cache-Control: private, max-age=3600`.

## Response `200`

Every template's summary.

- TemplateList
  - `count` integer
  - `schema` string: The design schema every template validates against.
  - `templates` TemplateSummary[]
    - `id` string
    - `sheets` string[]: Sheet names.
    - `nodes` integer
    - `componentCounts` object: Node count by type, e.g. { "SMPS": 3, "Load": 3 }.
    - `notes` string[]: The explanatory text the template carries on canvas.
    - `url` string: Where to read the document: /v1/templates/{id}.

## Other responses

- `401`: No key, a browser token instead of a key, an unknown key, or a revoked key (code KEY_REVOKED).
- `403`: The key lacks a required scope (INSUFFICIENT_SCOPE), or the call needs a plan the account does not have (PLAN_REQUIRED): on the Free plan, compare, exports, Monte Carlo jobs, AI synthesis, a design with more than one sheet, or a save, share or key past the Free limits; or a team key whose team is no longer paid for.
- `429`: RATE_LIMITED: the key's per-minute allowance is used up (or, before any key is recognised, too many requests from one address presented an unknown or revoked key). On the routes that solve inside the request (solve, verify, derating, compare, exports, ai/review, ai/synthesize) it can also be SOLVE_IN_PROGRESS: this account already has 3 calls of that kind running on the server that took the request (solves, AI reviews and syntheses are each counted separately). `Retry-After` is set either way; for SOLVE_IN_PROGRESS it is 2 s for solves and 30 s for AI reviews and syntheses.

---

[API](https://skmtc.dev/electronics-architect/apis/electronics-architect-api.md) · [All operations](https://skmtc.dev/electronics-architect/apis/electronics-architect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/electronics-architect/apis/electronics-architect-api/revisions/98066184ba67?raw)
