Full greenhouse-gas time series for one country
Returns every column in the OWID CO2 bundle for one ISO 3166-1 alpha-3 coded country. Covers CO2 totals, CO2 by source (coal, oil, gas, cement, flaring, other, land-use change), consumption-based CO2, cumulative CO2, share-of-global contributions, methane, nitrous oxide, total greenhouse gases, temperature-change contributions, population, GDP, and primary energy. Annual cadence. Early rows (pre-1900) carry only cement and basic CO2 columns; later decades populate progressively more columns as upstream measurement starts. For regional aggregates (World, EU27, OECD, Africa) use /world or /region/{region} - ISO3 coverage is for sovereign countries only. Published under CC BY 4.0 with dual attribution to Our World in Data and the per-column primary provider.
Path parameters
ISO 3166-1 alpha-3 country code. Case-insensitive; normalised to uppercase.
ISO 3166-1 alpha-3 country code. Case-insensitive; normalised to uppercase.
Query parameters
Inclusive start year (integer). Bundle range is 1750-present.
Inclusive start year (integer). Bundle range is 1750-present.
Inclusive end year (integer). Defaults to the latest year in the bundle.
Inclusive end year (integer). Defaults to the latest year in the bundle.
Response
All 79 columns for one country as an annual time series, plus attribution.
Example response
{
"data": {
"iso_code": "USA",
"country": "United States",
"observations": [
{
"year": 2022
}
],
"count": 275,
"start_year": 2000,
"end_year": 2023
},
"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"
]
}
}