Research

Full Penn World Table time series for one country

Changed on

Returns the country-year panel for one ISO 3166-1 alpha-3 coded country across all Penn World Table variables (or a caller-chosen subset). Annual cadence. Covers real GDP (expenditure and output side, both current and chained PPPs), national accounts, population, employment, human capital index, capital stock, TFP levels and growth rates, labor share, price levels, expenditure shares, and data-flag metadata. Not every country has full 1950 coverage - post-Soviet and post-Yugoslav states typically start around 1990-1992. Published under CC BY 4.0 with attribution to Penn World Table (Feenstra, Inklaar & Timmer, University of Groningen).

get/api/v1/research/pwt/country/{iso3}

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/research/pwt/country/{iso3}
  • Auth: API key in header x-api-key

Path parameters

iso3string required

ISO 3166-1 alpha-3 country code. Case-insensitive; normalised to uppercase.

Query parameters

start_yearinteger nullable

Inclusive start year (integer). Panel range starts 1950.

end_yearinteger nullable

Inclusive end year (integer). Defaults to the latest year in the panel.

variablesstring nullable

Comma-separated variable names to return (e.g. rgdpo,pop,emp,hc). Omit to receive every variable in the panel.

versionstring nullable

Release selector. pwt1100 (default) or pwt1001 (legacy).

Response

Full country-year panel slice for one country across the requested variable subset.

Example response

{
  "data": {
    "version": "pwt1100",
    "countrycode": "USA",
    "country": "United States",
    "currency_unit": "US Dollar",
    "observations": [
      {
        "year": 2020,
        "countrycode": "USA",
        "country": "United States",
        "currency_unit": "US Dollar"
      }
    ],
    "count": 74,
    "start_year": 1950,
    "end_year": 2023
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

  • bb59bcb0e35fRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • d2472ec2cf81Revision changes
    • info

      added the non-success response with the status