Skip to content

List templates

GET/templates

Costs 1 rate-limit point · Rate limits

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).

Also searched aslist templateswhich templates do I havedefault invoice templatepacking slip templatesshow my templatestemplate list

Query parameters

  • pageinteger

    Page number, from 1.

  • per_pageinteger

    Rows per page, 1-100 (default 25).

  • document_typestring

    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 invoicepacking_slipquotecredit_notereturn_form

Returns

  • itemsarray of objects
    Show 8 child attributesHide child attributes
    • idinteger
      Example: 135
    • namestring
      Example: Slip
    • document_typestring
      Example: packing_slip
    • designobject, nullable
    • default_forobject
      Show 4 child attributesHide child attributes
      • ordersboolean
        Example: false
      • draft_ordersboolean
        Example: false
      • pos_ordersboolean
        Example: false
      • credit_notesboolean
        Example: false
    • logoobject
      Show 4 child attributesHide child attributes
      • enabledboolean
        Example: true
      • urlstring, nullable
      • widthinteger
        Example: 150
      • lock_aspect_ratioboolean
        Example: true
    • created_atstring
      Example: 2026-11-10T09:07:41Z
    • updated_atstring
      Example: 2026-11-10T09:07:41Z
  • pageobject

    Offset paging of a list (page, per_page query params).

    Show 4 child attributesHide child attributes
    • numberinteger

      1-based page number.

    • sizeinteger

      Rows per page, max 100.

    • totalinteger

      Rows across all pages.

    • total_pagesinteger
      Example: 1

Errors

401

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

403

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

422

The request failed validation. Nothing was saved.

429

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

Every error has the same shape: see Errors.

GET/templates
curl "https://app.invoicefalcon.com/api/v3/external/templates" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "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
  }
}