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: AUS, CAN, DEU, FRA, GBR, JPN, MYS, SGP, and USA.
`period`	No	query · YYYY-QN	Omit it for the latest accepted complete release, or pass one exact period.

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 complete approved publication matches the request.
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

Quarterly year-over-year and quarter-over-quarter growth are public for AUS, CAN, DEU, FRA, GBR, JPN, MYS, SGP, and USA. The optional year_to_date field appears only when the official source publishes it.

Indonesia, regional routes, Commodities, and FX are not part of the public beta.

Return to all Economics operations.