---
title: "List templates"
description: "The store's document templates (invoices, packing slips, quotes, credit notes, return forms), newest first: name, document type, the design it started from, which order kinds it is the default for, and its logo. Filter w"
url: https://docs.invoicefalcon.com/v3-reference/templates/list-templates/
api: "API v3 reference"
method: GET
path: "/templates"
---

# List templates

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

The store's document templates (invoices, packing slips, quotes, credit notes, return forms), newest first: name, document type, the design it started from, which order kinds it is the default for, and its logo. Filter with `document_type`. Read-only.

`document_type` values: `invoice` (Invoice), `packing_slip` (Packing slip), `quote` (Quote), `credit_note` (Credit note), `return_form` (Return form).

## Query parameters

- `page` (integer): Page number, from 1.
- `per_page` (integer): Rows per page, 1-100 (default 25).
- `document_type` (string): Only templates of this type: invoice, packing_slip, quote, credit_note or return_form. One of: `invoice` (Invoice), `packing_slip` (Packing slip), `quote` (Quote), `credit_note` (Credit note), `return_form` (Return form). One of: `invoice`, `packing_slip`, `quote`, `credit_note`, `return_form`.

## Returns

- `items` (array of objects, required)
  - `id` (integer): e.g. `135`
  - `name` (string): e.g. `Slip`
  - `document_type` (string): e.g. `packing_slip`
  - `design` (object, nullable)
  - `default_for` (object)
    - `orders` (boolean): e.g. `false`
    - `draft_orders` (boolean): e.g. `false`
    - `pos_orders` (boolean): e.g. `false`
    - `credit_notes` (boolean): e.g. `false`
  - `logo` (object)
    - `enabled` (boolean): e.g. `true`
    - `url` (string, nullable)
    - `width` (integer): e.g. `150`
    - `lock_aspect_ratio` (boolean): e.g. `true`
  - `created_at` (string): e.g. `2026-11-10T09:07:41Z`
  - `updated_at` (string): e.g. `2026-11-10T09:07:41Z`
- `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/)).

## Examples

### List templates

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

### List templates filtered by document_type

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

## 200

One page of rows.

```json
{
  "items": [
    {
      "id": 135,
      "name": "Slip",
      "document_type": "packing_slip",
      "design": null,
      "default_for": {
        "orders": false,
        "draft_orders": false,
        "pos_orders": false,
        "credit_notes": false
      },
      "logo": {
        "enabled": true,
        "url": null,
        "width": 150,
        "lock_aspect_ratio": true
      },
      "created_at": "2026-11-10T09:07:41Z",
      "updated_at": "2026-11-10T09:07:41Z"
    }
  ],
  "page": {
    "number": 1,
    "size": 25,
    "total": 1,
    "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"
}
```

