---
title: "Retrieve version"
description: "One saved revision of a template with the before and after value of every field that changed in that save. Read-only."
url: https://docs.invoicefalcon.com/v3-reference/templates/retrieve-version/
api: "API v3 reference"
method: GET
path: "/templates/{id}/versions/{version_id}"
---

# Retrieve version

`GET https://app.invoicefalcon.com/api/v3/external/templates/{id}/versions/{version_id}`

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

## Path parameters

- `id` (string, required): Template id.
- `version_id` (string, required): Version id from the versions list.

## Returns

- `id` (integer): e.g. `20`
- `label` (string, nullable)
- `event` (string): e.g. `update`
- `created_at` (string): e.g. `2026-11-10T09:07:41Z`
- `changed_fields` (array of strings)
- `changes` (object)
  - `accent_color` (object)
    - `from` (string): e.g. `#000000`
    - `to` (string): e.g. `#ff0000`
  - `show_sku` (object)
    - `from` (boolean): e.g. `true`
    - `to` (boolean): e.g. `false`

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

## Example request

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

## 200

The requested resource.

```json
{
  "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
    }
  }
}
```

## 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"
}
```

## 404

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

```json
{
  "errors": [
    "Resource not found"
  ],
  "code": "not_found"
}
```

## 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"
}
```

