Skip to content

Retrieve version

GET/templates/{id}/versions/{version_id}

Costs 1 rate-limit point · Rate limits

One saved revision of a template with the before and after value of every field that changed in that save. Read-only.

Also searched asshow template versionwhat did this template edit changetemplate revision detailscompare template version

Path parameters

  • idstringRequired

    Template id.

  • version_idstringRequired

    Version id from the versions list.

Returns

  • idinteger
    Example: 20
  • labelstring, nullable
  • eventstring
    Example: update
  • created_atstring
    Example: 2026-11-10T09:07:41Z
  • changed_fieldsarray of strings
  • changesobject
    Show 2 child attributesHide child attributes
    • accent_colorobject
      Show 2 child attributesHide child attributes
      • fromstring
        Example: #000000
      • tostring
        Example: #ff0000
    • show_skuobject
      Show 2 child attributesHide child attributes
      • fromboolean
        Example: true
      • toboolean
        Example: false

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/{version_id}
curl "https://app.invoicefalcon.com/api/v3/external/templates/125/versions/{version_id}" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "id": 20,
  "label": null,
  "event": "update",
  "created_at": "2026-11-10T09:07:41Z",
  "changed_fields": [
    "accent_color",
    "show_sku"
  ],
  "changes": {
    "accent_color": {
      "from": "#000000",
      "to": "#ff0000"
    },
    "show_sku": {
      "from": true,
      "to": false
    }
  }
}