Environment

Catalog of entities, year range, metrics, and regions

Changed on

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).

get/api/v1/environment/co2/catalog

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/environment/co2/catalog
  • Auth: API key in header x-api-key

Response

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

Example response

{
  "data": {
    "entities": [
      {
        "country": "United States",
        "iso_code": "USA",
        "first_year": 1800,
        "last_year": 2024
      }
    ],
    "entity_count": 254,
    "country_count": 218,
    "region_count": 36,
    "year_range": {
      "max": 2024,
      "min": 1750
    },
    "metric_count": 76,
    "dataset_last_modified": "2025-12-04T13:20:04Z"
  },
  "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