Catalog of entities, year range, metrics, and regions

Discovery endpoint for the Our World in Data CO2 and Greenhouse Gas Emissions bundle. Lists every entity in the dataset (254 on the December 2025 vintage), the year range covered, every metric column name, and the whitelist of region aggregates accepted by /region/{region}. Use this before calling /country/{iso3}, /country/{iso3}/{metric}, or /top to confirm the exact metric spelling and the ISO codes for the countries of interest. Published under CC BY 4.0 - dual attribution to Our World in Data and the primary upstream providers named in the codebook (Global Carbon Project, Jones et al., EIA, Energy Institute, Maddison Project, OWID Population).

Responses

🟢200OK

application/json

Catalog payload with entity list, year range, metric list, and region whitelist.

Bodyapplication/json

Example

{
    "data": {
        "entities": [
            {
                "country": "United States",
                "iso_code": "string",
                "first_year": 0,
                "last_year": 0
            }
        ],
        "entity_count": 254,
        "country_count": 218,
        "region_count": 36,
        "year_range": {
            "max": 2024,
            "min": 1750
        },
        "metric_count": 76,
        "metrics": [
            "string"
        ],
        "regions": [
            "string"
        ],
        "dataset_last_modified": "string",
        "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

🟠429

🔴503Service Unavailable

Catalog of entities, year range, metrics, and regions

Request

Request Code Samples

Responses