---
title: "List designs"
description: "The app-owned starting designs a new template can be created from (Standard, Classic, Modern and so on): key, name, description and document type. Static; the same for every store. Read-only."
url: https://docs.invoicefalcon.com/v3-reference/templates/list-designs/
api: "API v3 reference"
method: GET
path: "/templates/designs"
---

# List designs

`GET https://app.invoicefalcon.com/api/v3/external/templates/designs`

The app-owned starting designs a new template can be created from (Standard, Classic, Modern and so on): key, name, description and document type. Static; the same for every store. Read-only.

## Query parameters

- `document_type` (string): Only designs for this document type.

## Returns

- `items` (array of objects, required)
  - `key` (string): e.g. `default`
  - `name` (string): e.g. `Standard`
  - `description` (string): e.g. `Clean, professional invoice with a right-aligned header a…`
  - `document_type` (string): e.g. `invoice`
- `page` (object, required): Offset paging of a list (`page`, `per_page` query params).
  - `number` (integer, required): 1-based page number.
  - `size` (integer, required): Rows per page, max 100.
  - `total` (integer, required): Rows across all pages.
  - `total_pages` (integer, required): e.g. `1`

Rate limit: this call costs 1 point ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl "https://app.invoicefalcon.com/api/v3/external/templates/designs" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
```

## 200

One page of rows.

```json
{
  "items": [
    {
      "key": "default",
      "name": "Standard",
      "description": "Clean, professional invoice with a right-aligned header and a bordered totals block.",
      "document_type": "invoice"
    },
    {
      "key": "classic",
      "name": "Classic",
      "description": "Traditional, formal layout with detailed sections — ideal for B2B and accounting.",
      "document_type": "invoice"
    },
    {
      "key": "modern",
      "name": "Modern",
      "description": "Bold accent banner header with a colored totals strip for a contemporary look.",
      "document_type": "invoice"
    }
  ],
  "page": {
    "number": 1,
    "size": 10,
    "total": 10,
    "total_pages": 1
  }
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

