Get revision history
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.
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
Query parameters
Indicator id, for example population or registered_unemployment_rate. List them with /api/v1/catalog.
Place name or id, for example Mataró, Texas, Japan, "Austin, TX", es-mun-08121, ES51 (NUTS), fips:48453 (US county) or fips:4805000 (US city).
One period to list every version of. Omit for the periods with more than one version in the whole series, or pass from and to.
First period, inclusive. Same formats as period.
Last period, inclusive. Same formats as period.
Force a frequency when the indicator exists in several.
ISO 3166-1 alpha-2 code that disambiguates the place, for example ES or US.
Language of names and definitions. Default en.
Response
Success. The body is {"data": ...}; the remaining allowance is in the x-invokely-remaining header.
Changes
No recorded changes to this operation across all 1 revision of this API.