Browse all documentation

Harmonised inflation API

Retrieve the latest harmonised inflation (HICP) for one country: the annual rate in percent.

economics_get_harmonised_inflation is available through REST and the economics_get_harmonised_inflation MCP tool. Both return the same data shape and use the same credit.

Endpoint and request

REST endpoint
GET /v1/economics/{country}/harmonised-inflation
Example request
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP uses tool economics_get_harmonised_inflation with the corresponding arguments below.

Parameters

The accepted period format for this operation is YYYY-MM.

NameRequiredTypeMeaning
countryYespath · ISO alpha-3One supported uppercase country code; see this operation’s coverage list.
periodNoquery · YYYY-MMOmit it for the latest accepted complete release, or pass one exact period.
series_idNoquery · UUIDOptional. Omit it for the annual rate, the default series. Pass the `series_id` of the index level to read the index instead. Find it with `GET /v1/economics/{country}/series?family=harmonised-inflation`: it is the series whose `unit` is `index`.

Response

Example response
{
  "source": {
    "publisher": "Eurostat",
    "distributor": "Eurostat"
  },
  "measure": "year_over_year",
  "seasonal_adjustment": "not_seasonally_adjusted",
  "classification": "COICOP 2018, all items (HICP total)",
  "period": "2026-10",
  "value": "3.7",
  "country": "FRA",
  "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
  "unit": "percent"
}
FieldTypeRequiredMeaning
sourceobjectYesWho published the figure. publisher is the statistics body whose figure it is, and distributor is the body Narwhal reads it from. One source per series, for its whole history. There is no released_on.
measurestringYesyear_over_year is the annual rate of change in percent. level is the index level.
seasonal_adjustmentstringYesAlways not_seasonally_adjusted.
classificationstringYesThe price aggregate the figure covers: all items, COICOP 2018.
base_periodstringNoThe year the index is 100 in. Present for the index level only.
base_valuedecimal stringNoThe index value in the base year. Present for the index level only.
periodstringYesThe official observation period returned.
valuedecimal stringYesThe figure in unit: the annual rate in percent, which can be negative, or the index level.
statusstringNoPresent only for a figure the publisher flags: estimated, break_in_series, definition_differs or break_in_series_and_definition_differs. Left out otherwise.
release_statusstringNopreliminary when the publisher marks the figure provisional. Left out otherwise.
countrystringYesThe requested uppercase ISO alpha-3 country code.
series_idstringYesThe series the figure comes from. Pass it as series_id to read the same series again.
unitstringYespercent for the annual rate, index for the index level.

Errors and credits

  • 400 invalid_query: A query parameter is unknown or repeated, country is not three uppercase letters, series_id is not a UUID, or period is not a month in YYYY-MM format. version_id, version and as_of are not accepted on this route.
  • 401 invalid_api_key: The Bearer key is missing or rejected.
  • 402 insufficient_credits: Your balance does not cover the call.
  • 404 series_not_found: The country is not in the coverage list on this page, series_id is not a series of that country, or no observation matches period. A country outside the list gets a detail that says the family is not available for it. A 404 is not charged.
  • 429 rate_limit_exceeded: The network or account short-window limit was reached. Retry after Retry-After.
  • 503 economics_unavailable: Narwhal cannot safely serve the stored series.

Only a successful data response costs credit. See all errors, headers, and retry rules.

Freshness

Omitting period returns the newest stored observation. The API call reads Narwhal's database. It does not call the publisher live. The answer has no released_on, because the date a distributor shows is not the publisher's release date.

Read how source checks, validation, stored releases, and failed checks work.

Current public-beta coverage

10 Countries

DNK, ESP, FIN, FRA, IRL, LVA, NLD, PRT, SVN, SWE

Monthly harmonised index of consumer prices (HICP), all items, from Eurostat, not seasonally adjusted. It is not the national inflation route, and the two figures for one country differ. The default series is the annual rate of change in percent, which can be negative. The index level has base 2025=100. A period is a month in YYYY-MM format. Any other country returns 404 series_not_found and is not charged. To read the index level, list the country's series first: GET /v1/economics/{country}/series?family=harmonised-inflation returns each series with its series_id, name, unit (percent or index) and is_default, and a request with limit and cursor pages through them. Pass the series_id whose unit is index to the latest or history route.

List the series

Example request
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/FRA/series?family=harmonised-inflation" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response
{
  "series": [
    {
      "country": "FRA",
      "series_id": "11bc022a-cd6e-4847-8ff8-11dae4e93451",
      "unit": "index",
      "name": "Harmonised index of consumer prices",
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "base_period": "2025",
        "base_value": "100",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "measure": "level",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    },
    {
      "country": "FRA",
      "series_id": "1b1f2448-2ba6-4523-a6ce-55c488ca15d1",
      "unit": "percent",
      "name": "Harmonised inflation, annual rate",
      "is_default": true,
      "frequency": "monthly",
      "first_period": "2000-01",
      "last_period": "2026-10",
      "family": "harmonised-inflation",
      "definition": {
        "measure": "year_over_year",
        "seasonal_adjustment": "not_seasonally_adjusted",
        "annualization": "not_annualized",
        "classification": "COICOP 2018, all items (HICP total)"
      }
    }
  ],
  "next_cursor": null
}

Daily FX is available through the FX API.

Return to all Economics operations.

Was this page helpful?