GDP growth API

Retrieve official real GDP growth measures for one quarter.

economics_get_gdp_growth is available through REST and the economics_get_gdp_growth MCP tool. Both return the same data shape and consume the same monthly quota.

Endpoint and request

REST endpoint

GET /v1/economics/{country}/gdp-growth

Example request

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP uses tool economics_get_gdp_growth with the corresponding arguments below.

Parameters

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

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-QN	Omit it for the latest accepted complete release, or pass one exact period.
`version_id`	No	query · UUID	Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

Response

Example response

{
  "country": "USA",
  "period": "2026-Q2",
  "year_over_year": "2.4",
  "quarter_over_quarter": "0.503",
  "unit": "percent",
  "price_basis": "constant",
  "seasonal_adjustment": "seasonally_adjusted",
  "annualization": "not_annualized",
  "released_on": "2026-07-30"
}

Field	Type	Required	Meaning
`country`	string	Yes	The requested uppercase ISO alpha-3 country code.
`period`	string	Yes	The official observation period returned.
`year_over_year`	decimal string	Yes	Real GDP change from the same quarter one year earlier.
`quarter_over_quarter`	decimal string	Yes	Real GDP change from the previous quarter.
`year_to_date`	decimal string	No	Official year-to-date growth when the source publishes it; otherwise omitted.
`unit`	"percent"	Yes	The unit for the growth measures.
`price_basis`	"constant"	Yes	Confirms that growth is calculated from real GDP.
`seasonal_adjustment`	enum	Yes	Whether the official series is seasonally adjusted.
`annualization`	enum	Yes	Whether the published growth rate is annualized.
`released_on`	date	Yes	The official publication date, not Narwhal's retrieval time.

Errors and quota

400 invalid_query — the country, period, or filter format is invalid.
401 invalid_api_key — the Bearer key is missing or rejected.
404 series_not_found — no approved observation matches the request.
429 rate_limit_exceeded — the network or account short-window limit was reached; retry after Retry-After.
429 quota_exhausted — the account has reached its monthly allowance.
503 economics_unavailable — Narwhal cannot safely serve an accepted publication.

Only a successful data response consumes quota. See all errors, headers, and retry rules.

Freshness

Omitting period returns Narwhal's latest stored accepted release. The API call reads Narwhal's database; it does not call the official publisher live.

released_on is the official publication date.

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

Current public-beta coverage

36 Countries

AUS, AUT, BEL, CAN, CHL, COL, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, HRV, IRL, ITA, JPN, LTU, LUX, LVA, MEX, MYS, NLD, NOR, NZL, PAK, PHL, POL, PRT, QAT, SAU, SGP, SVN, SWE, USA

Quarterly year-over-year and quarter-over-quarter growth follow the country list below. The optional year_to_date field appears only when the official source publishes it.

Indonesia and regional Economics routes are not public. Daily FX is available through the FX API.

Return to all Economics operations.