Single metric time series for one country
Returns a lean (year, value) series for a single metric column in the OWID CO2 bundle. The metric name must match one of the 76 column keys from the codebook exactly (e.g. co2, co2_per_capita, consumption_co2, methane, nitrous_oxide, temperature_change_from_co2, share_global_co2, cumulative_co2). Call /api/v1/environment/co2/codebook for the full column list with units and descriptions. Published under CC BY 4.0 with dual attribution - the response names the primary upstream provider for this specific column (Global Carbon Project, Jones et al., EIA, etc).
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.
Metric column name from the codebook (e.g. co2, co2_per_capita, methane, temperature_change_from_co2).
Metric column name from the codebook (e.g. co2, co2_per_capita, methane, temperature_change_from_co2).
Query parameters
Inclusive start year (integer). Bundle range is 1750-present.
Inclusive start year (integer). Bundle range is 1750-present.
Inclusive end year. Defaults to the latest year in the bundle.
Inclusive end year. Defaults to the latest year in the bundle.
Response
Year-value pairs for one metric plus unit, description, and per-column attribution.
Example response
{
"data": {
"iso_code": "USA",
"country": "United States",
"metric": "co2",
"unit": "million tonnes",
"observations": [
{
"year": 2022,
"value": 5055.403
}
],
"count": 30
},
"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"
]
}
}