---
title: "Get revision history"
method: GET
path: "/api/v1/revisions"
---

# Get revision history

`GET /api/v1/revisions`

## Request

- Base URL: `https://invokely.ai`
- URL: `https://invokely.ai/api/v1/revisions`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
  - none

List every version Invokely has kept of a figure: each time the publisher revised it, or only changed its status (for example provisional to final).
Use it for "how was the August CPI revised", "has this figure changed since it was first published", or to audit a number used earlier. For the figure at one past instant, call get_value with as_of instead.
Pass period for one figure. Without period, or with from and to, it lists up to 60 periods with more than one version, newest first, and the summary (counts and largest_change) covers the whole range.
Example: {"indicator": "cpi_annual_change", "place": "Spain", "period": "2026-08"}.
Returns {indicator, place, frequency, periods: [{period, revisions, status_changes, confirmed_final?, first_value, latest_value, change, versions: [{version, value, status?, known_from, known_until, published?, source_url}], note?}], summary: {periods, periods_revised, revisions, status_changes, largest_change?}, vintage_coverage_starts?, truncated?, source}. revisions counts changes of the value; status_changes counts new versions with the same value and another status, and confirmed_final is when a provisional or estimated value became final unchanged. A value only confirmed as final was not revised; do not say it was. known_until is null for the current version; published is the publisher's own release time when known.
Versions start when Invokely first retrieved the series (vintage_coverage_starts); revisions the publisher made before that are not included. Cite source.citation.

## Query parameters

- `indicator` string, required
- `place` string, required
- `period` string
- `from` string
- `to` string
- `frequency` 'year' | 'half' | 'quarter' | 'month'
- `country` string
- `locale` 'en' | 'es'

## Response `200`

Success. The body is {"data": ...}; the remaining allowance is in the x-invokely-remaining header.

- Data
  - `data` unknown, required

## Other responses

- `400`: Invalid argument (INVALID_ARGUMENT).
- `401`: The API key or token is invalid or revoked (UNAUTHORIZED).
- `402`: Allowance used up (QUOTA_EXHAUSTED), or the plan does not include the REST API (PLAN_REQUIRED: Free keys; use the MCP server or upgrade to Builder).
- `404`: Unknown indicator or place, or no data (INDICATOR_NOT_FOUND, PLACE_NOT_FOUND, AMBIGUOUS_PLACE, NO_DATA). hint and suggestions say what to try next.
- `429`: Rate limited (RATE_LIMITED). Retry after retry_after_seconds.

---

[API](https://skmtc.dev/invokely/apis/invokely-statistics-api.md) · [All operations](https://skmtc.dev/invokely/apis/invokely-statistics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/invokely/apis/invokely-statistics-api/revisions/3b0f775bccb6?raw)