Industrial production history API
Retrieve the monthly industrial production index for one country, oldest first.
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}/industrial-production/observationscurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/industrial-production/observations?start=2026-01&limit=2" \
--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. |
start | No | query · YYYY-MM | Inclusive first observation period. |
end | No | query · YYYY-MM | Inclusive last observation period. |
limit | No | query · integer, 1–1000 | Maximum number of periods returned. Defaults to 100. A page may contain fewer periods; follow next_cursor. |
cursor | No | query · opaque string | The next_cursor from the previous page. |
series_ | No | query · UUID | Optional. The `series_id` of one series, taken from an earlier answer. Omit it to read the country's default series. |
Response
{
"source": {
"publisher": "OECD",
"distributor": "OECD"
},
"seasonal_adjustment": "seasonally_and_calendar_adjusted",
"base_period": "2015",
"base_value": "100",
"country": "USA",
"series_id": "ea690cc4-a528-4c6d-b07a-5ecbdac08575",
"unit": "index",
"observations": [
{
"period": "2026-01",
"value": "100.1"
},
{
"period": "2026-02",
"value": "100.9"
}
],
"next_cursor": "eyJhZnRlciI6IjIwMjYtMDIi…"
}The history example asks for limit=2, so it holds two rows. next_ is shortened here. A real one is a longer opaque string.
| 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_. |
seasonal_ | string | Yes | Always seasonally_. |
base_ | string | Yes | The year the index is 100 in: 2021 for Eurostat series, 2015 for OECD series. |
base_ | decimal string | Yes | The index value in the base year. 100 for every series here. |
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 | Always index. |
observations | array | Yes | Oldest-first observations, one per period. A page can hold fewer observations than limit. Follow next_ until it is null. |
observations[].period | string | Yes | The official month, quarter or year represented by the observation. |
observations[].value | decimal string | Yes | The index level, with its base in base_ and base_. It is a level, not a growth rate. |
observations[].status | string | No | Present only for a figure the publisher flags: estimated, break_, definition_ or break_. Left out otherwise. |
observations[].release_ | string | No | preliminary when the publisher marks the figure provisional. Left out otherwise. |
next_ | string or null | Yes | Pass this unchanged as cursor to read the next page. It is null on the last page. |
Errors and credits
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID,id startorendis not a month inYYYY-MMformat,startandenddiffer in format orstartis afterend, orlimitis outside 1 to 1000.version_,id versionandas_are not accepted on this route.of 400 invalid_: The cursor is malformed, or was issued for other filters.cursor 409 snapshot_: The cursor is more than 24 hours old and has expired. Start again withoutunavailable cursor.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 the range holds no observation. A country outside the list gets a detail that says the family is not available for it. A 404 is not charged.id 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
This route returns Narwhal's current stored series, oldest first. Without start it begins at the oldest stored period, so pass start to read recent periods. It does not take as_ or version, so an earlier vintage cannot be read. Narwhal omits missing observations rather than filling them.
Read how source checks, validation, stored releases, and failed checks work.
Current public-beta coverage
15 Countries
BEL, BGR, BRA, CHL, CZE, EST, FIN, FRA, HRV, IRL, ITA, KOR, SVN, SWE, USA
Monthly index level, calendar and seasonally adjusted. Eurostat series use 2021=100 and OECD series use 2015=100, and source and base_ say which one a country has. Bases differ by country, so compare levels within one country only. A period is a month in YYYY-MM format. Any other country returns 404 not_ and is not charged.
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?