---
title: "List templates"
description: "Retrieve all templates for the authenticated store."
url: https://docs.invoicefalcon.com/api/templates/list-templates/
api: "API v1 reference"
method: GET
path: "/templates"
---

# List templates

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

Retrieve all templates for the authenticated store.

## Returns

- `templates` (array of objects)
  - `id` (integer): Use as `template_id` in pdf/send_email/create.
  - `name` (string): e.g. `Default invoice`
  - `template_type` (string): e.g. `invoice` One of: `invoice`, `packing_slip`, `credit_note`.
  - `design_key` (string, nullable): e.g. `classic`
  - `pre_selected_orders` (boolean): e.g. `true`
  - `pre_selected_draft_orders` (boolean): e.g. `false`
  - `pre_selected_pos_orders` (boolean): e.g. `false`
  - `pre_selected_credit_notes` (boolean): e.g. `false`
  - `accent_color` (string): e.g. `#1F6FEB`
  - `font_family` (string): e.g. `Helvetica`
  - `font_size` (integer): e.g. `11`
  - `date_format` (string): e.g. `%d %b %Y`
  - `invoice_number_prefix` (string): e.g. `INV-`
  - `logo_url` (string, nullable): e.g. `https://example.com/logo.png`
  - `logo_width` (integer): e.g. `120`
  - `logo_enabled` (boolean): e.g. `true`
  - `created_at` (string): e.g. `2025-11-03T14:02:00Z`
  - `updated_at` (string): e.g. `2026-01-10T08:15:00Z`

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

## Example request

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

## 200

A list of templates.

```json
{
  "templates": [
    {
      "id": 311,
      "name": "Default invoice",
      "template_type": "invoice",
      "design_key": "classic",
      "pre_selected_orders": true,
      "pre_selected_draft_orders": false,
      "pre_selected_pos_orders": false,
      "pre_selected_credit_notes": false,
      "accent_color": "#1F6FEB",
      "font_family": "Helvetica",
      "font_size": 11,
      "date_format": "%d %b %Y",
      "invoice_number_prefix": "INV-",
      "logo_url": "https://example.com/logo.png",
      "logo_width": 120,
      "logo_enabled": true,
      "created_at": "2025-11-03T14:02:00Z",
      "updated_at": "2026-01-10T08:15:00Z"
    },
    {
      "id": 312,
      "name": "Packing slip",
      "template_type": "packing_slip",
      "design_key": null,
      "pre_selected_orders": false,
      "pre_selected_draft_orders": false,
      "pre_selected_pos_orders": false,
      "pre_selected_credit_notes": false,
      "accent_color": "#1F6FEB",
      "font_family": "Helvetica",
      "font_size": 11,
      "date_format": "%d %b %Y",
      "invoice_number_prefix": "",
      "logo_url": null,
      "logo_width": 120,
      "logo_enabled": false,
      "created_at": "2025-12-01T10:00:00Z",
      "updated_at": "2025-12-01T10:00:00Z"
    }
  ]
}
```

## 401

Missing or invalid API key.

```json
{
  "error": "Invalid API key"
}
```

## 403

The store is not on a paid plan. API access requires a paid Invoice Falcon plan.

```json
{
  "error": "REST API access requires a paid plan"
}
```

## 429

Rate limit exceeded. Check `X-RateLimit-Reset` header.

```json
{
  "error": "Rate limit exceeded",
  "retry_after": 30,
  "message": "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 30 second(s)."
}
```

