World aggregate time series (sum or mean across countries)

GET

/api/v1/research/pwt/world

Last modified:2026-07-19 17:02:26

Maintainer:Not configured

OperationId:research_pwt_world

Returns a Sugra-computed world aggregate across all Penn World Table countries for the requested variable subset. Pick aggregation=sum for level variables that add meaningfully across countries (rgdpo, rgdpe, pop, emp, cn, ccon), or aggregation=mean for unitless indices, shares, and price levels (hc, ctfp, cwtfp, labsh, pl_gdpo, csh_*). The Penn World Table upstream dataset does not ship a World row; this endpoint derives one at request time. Null values in the panel are skipped from the aggregate. Not every country contributes in every year, so the mix of contributing countries varies by year - keep this in mind for long-run world totals. Published under CC BY 4.0 with attribution to Penn World Table (Feenstra, Inklaar & Timmer, University of Groningen).

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/research/pwt/world?variables=rgdpo%2Cpop%2Cemp&aggregation=sum&version=pwt1100' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

World-aggregate time series across the requested variable subset.

Bodyapplication/json

Example

{
    "data": {
        "version": "pwt1100",
        "aggregation": "sum",
        "variables": [
            "string"
        ],
        "observations": [
            {
                "year": 2020,
                "countrycode": "string",
                "country": "string",
                "currency_unit": "string",
                "property1": "string",
                "property2": "string"
            }
        ],
        "count": 74,
        "attribution": "string"
    },
    "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",
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴503Service Unavailable

Modified at 2026-07-19 17:02:26

Variable dictionary and methodology notes

Side-by-side comparison of countries for one variable-year