Skip to content

List versions

GET/templates/{id}/versions

Costs 1 rate-limit point · Rate limits

A template's saved revisions, newest first (the last 15 edits are kept): when each was saved, its label if the merchant named it, and which fields changed. Read-only.

Also searched astemplate historytemplate versionswhat changed in my templateprevious template versionswhen was the template last edited

Path parameters

  • idstringRequired

    Template id.

Query parameters

  • pageinteger

    Page number, from 1.

  • per_pageinteger

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

Returns

  • itemsarray of objects
    Show 5 child attributesHide child attributes
    • idinteger
      Example: 20
    • labelstring, nullable
    • eventstring
      Example: update
    • created_atstring
      Example: 2026-11-10T09:07:41Z
    • changed_fieldsarray of strings
  • 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.

404

The resource does not exist for this shop, or no action is registered at this path.

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/{id}/versions
curl "https://app.invoicefalcon.com/api/v3/external/templates/125/versions" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "items": [
    {
      "id": 20,
      "label": null,
      "event": "update",
      "created_at": "2026-11-10T09:07:41Z",
      "changed_fields": [
        "accent_color",
        "show_sku"
      ]
    }
  ],
  "page": {
    "number": 1,
    "size": 25,
    "total": 1,
    "total_pages": 1
  }
}