Research

Variable dictionary and methodology notes

Changed on

Returns the variable dictionary shipped with the selected Penn World Table release - one entry per column with name, description (from the release Legend sheet), and type grouping. Includes a short methodology note summarising the expenditure- vs output-side real GDP distinction, the perpetual-inventory capital stock construction, TFP levels, and the human capital index. Use before querying other endpoints to confirm variable names and decode column meanings without reading the upstream user guide. Published under CC BY 4.0 with attribution to Penn World Table (Feenstra, Inklaar & Timmer, University of Groningen).

get/api/v1/research/pwt/definitions

Request

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

Query parameters

versionstring nullable

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

Response

Variable dictionary with grouped descriptions plus release methodology note.

Example response

{
  "data": {
    "version": "pwt1100",
    "label": "PWT 11.0",
    "base_year": "2021",
    "doi": "10.34894/FABVLR",
    "release_time": "2025-10-10T11:49:22Z",
    "user_guide_url": "https://dataverse.nl/file.xhtml?persistentId=doi:10.34894/FABVLR",
    "definitions_count": 51,
    "definitions": [
      {
        "name": "rgdpo",
        "description": "Output-side real GDP at chained PPPs (in mil. 2021US$)",
        "type": "real-gdp-ppp"
      }
    ]
  },
  "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