Harmonised inflation API
Retrieve the latest harmonised inflation (HICP) for one country: the annual rate in percent.
economics_ is available through REST and the economics_ MCP tool. Both return the same data shape and use the same credit.
Endpoint and request
GET /v1/economics/{country}/harmonised-inflationcurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/FRA/harmonised-inflation" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCP uses tool economics_ with the corresponding arguments below.
Parameters
The accepted period format for this operation is YYYY-MM.
| Name | Required | Type | Meaning |
|---|---|---|---|
country | Yes | path · ISO alpha-3 | One supported uppercase country code; see this operation’s coverage list. |
period | No | query · YYYY-MM | Omit it for the latest accepted complete release, or pass one exact period. |
series_ | No | query · UUID | Optional. 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
{
"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"
}| Field | Type | Required | Meaning |
|---|---|---|---|
source | object | Yes | Who 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_. |
measure | string | Yes | year_ is the annual rate of change in percent. level is the index level. |
seasonal_ | string | Yes | Always not_. |
classification | string | Yes | The price aggregate the figure covers: all items, COICOP 2018. |
base_ | string | No | The year the index is 100 in. Present for the index level only. |
base_ | decimal string | No | The index value in the base year. Present for the index level only. |
period | string | Yes | The official observation period returned. |
value | decimal string | Yes | The figure in unit: the annual rate in percent, which can be negative, or the index level. |
status | string | No | Present only for a figure the publisher flags: estimated, break_, definition_ or break_. Left out otherwise. |
release_ | string | No | preliminary when the publisher marks the figure provisional. Left out otherwise. |
country | string | Yes | The requested uppercase ISO alpha-3 country code. |
series_ | string | Yes | The series the figure comes from. Pass it as series_ to read the same series again. |
unit | string | Yes | percent for the annual rate, index for the index level. |
Errors and credits
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID, orid periodis not a month inYYYY-MMformat.version_,id versionandas_are not accepted on this route.of 401 invalid_: The Bearer key is missing or rejected.api_ key 402 insufficient_: Your balance does not cover the call.credits 404 series_: The country is not in the coverage list on this page,not_ found series_is not a series of that country, or no observation matchesid 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_: The network or account short-window limit was reached. Retry afterlimit_ exceeded Retry-After.503 economics_: Narwhal cannot safely serve the stored series.unavailable
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_, 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_ and is not charged. To read the index level, list the country's series first: GET / returns each series with its series_, name, unit (percent or index) and is_, and a request with limit and cursor pages through them. Pass the series_ whose unit is index to the latest or history route.
List the series
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/FRA/series?family=harmonised-inflation" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"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.
Start with a free key
Free $10 credits every month, no card.Free $10 credits a month, no card.
Was this page helpful?