API Documentation

⌘K
Get free key
GET/api/1/macro/gdp/{country}

Country GDP Outlook API

Nominal GDP in current US dollars for one country: the last 10 calendar years and a 5-year forward estimate. History and IMF World Economic Outlook projections are returned as published. When the WEO forecast does not cover five years ahead but the series is current, the missing years are Eulerpool estimates (source "eulerpool") compounded from recent nominal growth. Accepts ISO2 (RU, DE) or ISO3 (RUS, DEU).

Parameters

Required first. Documented defaults are selected — Test Request matches a bare call.

1
countrystringrequired
path

ISO2 or ISO3 country code (e.g. RU, RUS, DE, DEU)

Responses

Was this helpful?
Request
curl -X GET \
  'https://api.eulerpool.com/api/1/macro/gdp/US' \
  -H 'Accept: application/json'
200 Response
{
  "country": "RUS",
  "iso2": "RU",
  "indicator": "NGDPD",
  "name": "GDP, current prices",
  "units": "Billions of U.S. dollars",
  "currency": "USD",
  "scale": "billions",
  "forecastFromYear": 2026,
  "historyYears": 10,
  "forecastYears": 5,
  "generated": false,
  "source": "imf",
  "series": {
    "year": 0,
    "value": 0,
    "isForecast": false,
    "source": "string"
  }
}