Environment

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

get/api/v1/environment/co2/catalog

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",
    "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"
    ]
  }
}

Changes

Changed in 1 of the 21 revisions of this API.12

Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history