Carbon Footprint and Emission Factor API

API ID 13267

Turn any activity, spend, freight, or flight into kg CO₂e from open, sourced data (UK DEFRA, US EPA, Ember, IPCC) plus live grid carbon intensity for GB, US & EU and 213 countries.

265 ms avg response

API Documentation

Endpoints

Request
Convert an activity + amount into kg CO₂e using open emission factors (DEFRA/EPA)
Endpoint ID: 27322
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27322/estimate+co2e
INPUT PARAMETERS

Estimate CO2e — Endpoint Features

Object Description
amount Required Quantity of the activity, expressed in unit.
unit Required Unit of the amount (litres, kWh, MWh, GJ, mmBtu, m3, kg, tonnes, km, miles…). Auto-converted to the factor's unit when compatible.
activity Optional Free-text activity to match (e.g. diesel, natural gas, electricity, petrol, coal). Required unless factor_id is given.
region Optional ISO-3 country code (GBR, USA, FRA) or US/UK/EU. Falls back to GB then US.
year Optional Reporting year for the factor; defaults to the latest available.
factor_id Optional Exact factor id to use, bypassing activity matching (from /factors/search).

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

amount
unit
activity
region
year
factor_id
API EXAMPLE RESPONSE
JSON
{
    "activity": "Diesel (100% mineral diesel)",
    "amount": 40,
    "unit": "litres",
    "region": "GB",
    "year": 2025,
    "co2e_kg": 106.462,
    "co2e_tonnes": 0.106462,
    "factor": {
        "id": "defra-2025-fuels-liquid-fuels-diesel-100-mineral-diesel-litres",
        "co2e_kg_per_unit": 2.66155,
        "unit": "litres",
        "region": "GB",
        "year": 2025,
        "scope": 1,
        "category": "Fuels",
        "data_quality": {
            "tier": "A",
            "score": 9,
            "max": 9,
            "basis": [
                "national government dataset",
                "vintage 2025",
                "activity-specific"
            ],
            "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
        }
    },
    "notes": [
        "selected by factor_id"
    ]
}
Estimate CO2e — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27322/estimate+co2e?amount=40&unit=litres&activity=diesel®ion=GB&year=2025&factor_id=defra-2025-fuels-liquid-fuels-diesel-100-mineral-diesel-litres' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Estimate CO₂e from US dollar spend by category/NAICS (EPA USEEIO), inflation-adjusted to the 2022 basis.
Endpoint ID: 27323
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27323/spend-based+scope+3
INPUT PARAMETERS

Spend-based Scope 3 — Endpoint Features

Object Description
amount Required Money spent, in USD
category Optional Free-text spend category, matched to a US NAICS industry. Required unless naics given
naics Optional Explicit 6-digit US NAICS code, bypassing category matching
currency Optional Currency of the amount; USD only
year Optional Year spent; amount is inflation-adjusted to 2022 USD

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

amount
category
naics
currency
year
API EXAMPLE RESPONSE
JSON
{
    "amount": 5000,
    "currency": "USD",
    "year": "2024",
    "category": "Data Processing, Hosting, and Related Services",
    "naics": "518210",
    "co2e_kg": 433.82,
    "co2e_tonnes": 0.43382,
    "factor": {
        "naics": "518210",
        "title": "Data Processing, Hosting, and Related Services",
        "kg_co2e_per_usd": 0.093,
        "ref_year": 2022,
        "basis": "purchaser price (with margins)"
    },
    "notes": [
        "inflation-adjusted 5000.0 USD (2024) -> 4664.73 in 2022 USD (US CPI-U)"
    ]
}
Spend-based Scope 3 — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27323/spend-based+scope+3?amount=5000&category=cloud hosting&naics=518210¤cy=USD&year=2024' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
CO₂e for moving goods per ISO 14083/GLEC (weight × distance × DEFRA freight factor by mode).
Endpoint ID: 27324
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27324/freight+co2e
INPUT PARAMETERS

Freight CO2e — Endpoint Features

Object Description
mode Required road, hgv, van, rail, sea, container, bulk, tanker, air.
weight_tonnes Required Weight of goods, in tonnes
distance_km Required Distance travelled, in km.
factor_id Optional Pin an exact DEFRA freight factor.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

mode
weight_tonnes
distance_km
factor_id
API EXAMPLE RESPONSE
JSON
{
    "mode": "road",
    "weight_tonnes": 12,
    "distance_km": 300,
    "tonne_km": 3600,
    "co2e_kg": 365.868,
    "co2e_tonnes": 0.365868,
    "method": "ISO 14083 / GLEC (distance x weight x freight factor)",
    "factor": {
        "id": "defra-2025-freighting-goods-hgv-all-diesel-all-hgvs-average-laden-tonne-km",
        "path": "Freighting goods / HGV (all diesel) / All HGVs (Average laden)",
        "kg_co2e_per_tonne_km": 0.10163
    },
    "notes": [
        "mode 'road' -> Freighting goods / HGV (all diesel) / All HGVs (Average laden)",
        "47 other road factors exist; pass factor_id to pin one"
    ]
}
Freight CO2e — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27324/freight+co2e?mode=road&weight_tonnes=12&distance_km=300' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Flight CO₂e between two airports (or a given distance) with a configurable radiative-forcing multiplier.
Endpoint ID: 27325
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27325/flight+co2e
INPUT PARAMETERS

Flight CO2e — Endpoint Features

Object Description
from Required Origin IATA; required (with to) unless distance_km given.
to Optional Destination IATA.
distance_km Optional Supply distance directly instead of from/to.
class Optional economy, premium, business, first, average.
passengers Optional Number of passengers.
round_trip Optional Double distance for a return trip.
rf Optional Double distance for a return trip.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

from
to
distance_km
class
passengers
round_trip
rf
API EXAMPLE RESPONSE
JSON
{
    "from": "LHR",
    "from_name": "London Heathrow Airport",
    "to": "JFK",
    "to_name": "John F. Kennedy International Airport",
    "distance_km": 5539.8,
    "haul": "Long-haul",
    "class": "economy",
    "passengers": 1,
    "round_trip": false,
    "passenger_km": 5539.8,
    "co2_only_kg": 383.6886,
    "co2e_kg": 729.0083,
    "co2e_tonnes": 0.729008,
    "rf_multiplier": 1.9,
    "official_with_rf_kg": 648.3816,
    "factor": {
        "id": "defra-2025-business-travel-air-flights-long-haul-to-from-uk-economy-class-without-rf-passenger-km",
        "path": "Business travel- air / Flights / Long-haul, to/from UK / Economy class (Without RF)",
        "kg_co2_per_passenger_km_without_rf": 0.06926
    },
    "notes": [
        "haul 'Long-haul' by great-circle distance; to/from-UK factor used",
        "rf=1.9 radiative-forcing multiplier applied to the CO2 base"
    ]
}
Flight CO2e — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27325/flight+co2e?from=LHR&to=JFK&distance_km=5540&class=economy&passengers=1&round_trip=false&rf=1.9' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Global Warming Potential and CO₂e for a refrigerant or F-gas (IPCC AR4/5/6; blends mass-weighted).
Endpoint ID: 27326
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27326/refrigerant+gwp
INPUT PARAMETERS

Refrigerant GWP — Endpoint Features

Object Description
gas Required R-number (R-410A), HFC name (HFC-134a), or gas name (Nitrous oxide).
kg Optional Mass in kg; if given, returns CO₂e too.
assessment Optional IPCC report: AR4, AR5, AR6.
horizon Optional Time horizon in years: 20, 100, 500.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

gas
kg
assessment
horizon
API EXAMPLE RESPONSE
JSON
{
    "gas": "R-410A",
    "gwp": 2255.5,
    "assessment": "AR6",
    "horizon_years": 100,
    "components": {
        "HFC-32": {
            "fraction": 0.5,
            "gwp": 771
        },
        "HFC-125": {
            "fraction": 0.5,
            "gwp": 3740
        }
    },
    "kg": 5,
    "co2e_kg": 11277.5,
    "co2e_tonnes": 11.2775
}
Refrigerant GWP — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27326/refrigerant+gwp?gas=R-410A&kg=5&assessment=AR6&horizon=100' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Full-text search across the emission-factor catalogue, with optional filters.
Endpoint ID: 27327
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27327/search+factors
INPUT PARAMETERS

Search Factors — Endpoint Features

Object Description
q Required Free-text query over activity/path/category/region/unit.
category Optional Filter by category.
region Optional Filter by factor region.
unit Optional Filter by the factor's unit.
year Optional Filter by year.
limit Optional Max results (≤100).

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

q
category
region
unit
year
limit
API EXAMPLE RESPONSE
JSON
{
    "count": 8,
    "query": "natural gas",
    "results": [
        {
            "activity": "natural-gas",
            "activity_label": "Natural gas",
            "category": "Fuels",
            "co2e_kg_per_unit": 2.06672,
            "gas_breakdown": {
                "ch4": 0.00307,
                "co2": 2.0627,
                "n2o": 0.00095
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-cubic-metres",
            "path": "Fuels / Gaseous fuels / Natural gas",
            "region": "GB",
            "scope": 1,
            "unit": "cubic metres",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        },
        {
            "activity": "natural-gas",
            "activity_label": "Natural gas",
            "category": "Fuels",
            "co2e_kg_per_unit": 0.18296,
            "gas_breakdown": {
                "ch4": 0.00028,
                "co2": 0.18259,
                "n2o": 9.0e-5
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-kwh-gross-cv",
            "path": "Fuels / Gaseous fuels / Natural gas",
            "region": "GB",
            "scope": 1,
            "unit": "kWh (Gross CV)",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        },
        {
            "activity": "natural-gas",
            "activity_label": "Natural gas",
            "category": "Fuels",
            "co2e_kg_per_unit": 0.2027,
            "gas_breakdown": {
                "ch4": 0.00031,
                "co2": 0.20229,
                "n2o": 0.0001
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-kwh-net-cv",
            "path": "Fuels / Gaseous fuels / Natural gas",
            "region": "GB",
            "scope": 1,
            "unit": "kWh (Net CV)",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        },
        {
            "activity": "natural-gas",
            "activity_label": "Natural gas",
            "category": "Fuels",
            "co2e_kg_per_unit": 2575.46441,
            "gas_breakdown": {
                "ch4": 3.8528,
                "co2": 2570.42,
                "n2o": 1.19161
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-tonnes",
            "path": "Fuels / Gaseous fuels / Natural gas",
            "region": "GB",
            "scope": 1,
            "unit": "tonnes",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        },
        {
            "activity": "natural-gas-100-mineral-blend",
            "activity_label": "Natural gas (100% mineral blend)",
            "category": "Fuels",
            "co2e_kg_per_unit": 2.08906,
            "gas_breakdown": {
                "ch4": 0.00307,
                "co2": 2.08504,
                "n2o": 0.00095
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-100-mineral-blend-cubic-metres",
            "path": "Fuels / Gaseous fuels / Natural gas (100% mineral blend)",
            "region": "GB",
            "scope": 1,
            "unit": "cubic metres",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        },
        {
            "activity": "natural-gas-100-mineral-blend",
            "activity_label": "Natural gas (100% mineral blend)",
            "category": "Fuels",
            "co2e_kg_per_unit": 0.18494,
            "gas_breakdown": {
                "ch4": 0.00028,
                "co2": 0.18457,
                "n2o": 9.0e-5
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-100-mineral-blend-kwh-gross-cv",
            "path": "Fuels / Gaseous fuels / Natural gas (100% mineral blend)",
            "region": "GB",
            "scope": 1,
            "unit": "kWh (Gross CV)",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        },
        {
            "activity": "natural-gas-100-mineral-blend",
            "activity_label": "Natural gas (100% mineral blend)",
            "category": "Fuels",
            "co2e_kg_per_unit": 0.20489,
            "gas_breakdown": {
                "ch4": 0.00031,
                "co2": 0.20448,
                "n2o": 0.0001
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-100-mineral-blend-kwh-net-cv",
            "path": "Fuels / Gaseous fuels / Natural gas (100% mineral blend)",
            "region": "GB",
            "scope": 1,
            "unit": "kWh (Net CV)",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        },
        {
            "activity": "natural-gas-100-mineral-blend",
            "activity_label": "Natural gas (100% mineral blend)",
            "category": "Fuels",
            "co2e_kg_per_unit": 2603.30441,
            "gas_breakdown": {
                "ch4": 3.8528,
                "co2": 2598.26,
                "n2o": 1.19161
            },
            "id": "defra-2025-fuels-gaseous-fuels-natural-gas-100-mineral-blend-tonnes",
            "path": "Fuels / Gaseous fuels / Natural gas (100% mineral blend)",
            "region": "GB",
            "scope": 1,
            "unit": "tonnes",
            "year": 2025,
            "data_quality": {
                "tier": "A",
                "score": 9,
                "max": 9,
                "basis": [
                    "national government dataset",
                    "vintage 2025",
                    "activity-specific"
                ],
                "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
            }
        }
    ]
}
Search Factors — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27327/search+factors?q=natural gas&category=Fuels®ion=GB' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
How a factor's value changed between two editions
Endpoint ID: 27328
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27328/factor+diff
INPUT PARAMETERS

Factor Diff — Endpoint Features

Object Description
id Required The factor id.
from Optional The start year.
to Optional The end year.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

id
from
to
API EXAMPLE RESPONSE
JSON
{
    "id": "defra-2025-fuels-liquid-fuels-diesel-100-mineral-diesel-litres",
    "identity": "fuels-liquid-fuels-diesel-100-mineral-diesel-litres",
    "from_year": 2023,
    "to_year": 2025,
    "from_value": 2.659372,
    "to_value": 2.66155,
    "absolute_change": 0.002178,
    "percent_change": 0.08,
    "unit": "litres"
}
Factor Diff — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27328/factor+diff?id=defra-2025-fuels-liquid-fuels-diesel-100-mineral-diesel-litres&from=2023&to=2025' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Find US NAICS industries (and their kg CO₂e per USD) for spend-based estimation.
Endpoint ID: 27329
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27329/search+industries+-naics
INPUT PARAMETERS

Search Industries -NAICS — Endpoint Features

Object Description
q Required Free-text industry query.
limit Optional Max results (<100)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

q
limit
API EXAMPLE RESPONSE
JSON
{
    "count": 7,
    "query": "consulting",
    "results": [
        {
            "naics": "541613",
            "title": "Marketing Consulting Services",
            "kg_co2e_per_usd": 0.078
        },
        {
            "naics": "541620",
            "title": "Environmental Consulting Services",
            "kg_co2e_per_usd": 0.09
        },
        {
            "naics": "541612",
            "title": "Human Resources Consulting Services",
            "kg_co2e_per_usd": 0.078
        },
        {
            "naics": "541618",
            "title": "Other Management Consulting Services",
            "kg_co2e_per_usd": 0.078
        },
        {
            "naics": "541690",
            "title": "Other Scientific and Technical Consulting Services",
            "kg_co2e_per_usd": 0.09
        },
        {
            "naics": "541614",
            "title": "Process, Physical Distribution, and Logistics Consulting Services",
            "kg_co2e_per_usd": 0.078
        },
        {
            "naics": "541611",
            "title": "Administrative Management and General Management Consulting Services",
            "kg_co2e_per_usd": 0.078
        }
    ]
}
Search Industries -NAICS — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27329/search+industries+-naics?q=consulting&limit=20' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Annual electricity grid carbon intensity for 213 countries (Ember) and 27 US eGRID subregions.
Endpoint ID: 27330
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27330/grid+intensity+-+annual
INPUT PARAMETERS

Grid Intensity - annual — Endpoint Features

Object Description
region Required ISO-3 code, US/UK/EU, or a US eGRID subregion (CAMX, US-RFCE).
year Optional Year; defaults to latest.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

region
year
API EXAMPLE RESPONSE
JSON
{
    "region": "US",
    "iso3": "USA",
    "year": 2025,
    "gco2_per_kwh": 384.4,
    "kg_co2e_per_kwh": 0.3844,
    "available_years": [
        2000,
        2025
    ]
}
Grid Intensity - annual — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27330/grid+intensity+-+annual?region=US&year=2025' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Live electricity grid carbon intensity for GB (NESO), US balancing authorities (EIA), and EU bidding zones (ENTSO-E).
Endpoint ID: 27331
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27331/live+grid+intensity
INPUT PARAMETERS

Live Grid Intensity — Endpoint Features

Object Description
zone Required GB, a US balancing authority (CISO, PJM, ERCO…), or an EU code (FR, DE, ES, PL, DK1, SE3…).

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

zone
API EXAMPLE RESPONSE
JSON
{
    "zone": "FR",
    "eic": "10YFR-RTE------C",
    "gco2_per_kwh": 10.2,
    "kg_co2e_per_kwh": 0.010195,
    "method": "computed from actual generation per production type x direct fuel CO2 factors (estimate; renewables/nuclear ~ 0)",
    "mix": [
        {
            "production_type": "B14",
            "mw": 36584.4,
            "gco2_per_kwh": 0
        },
        {
            "production_type": "B16",
            "mw": 20653.2,
            "gco2_per_kwh": 0
        },
        {
            "production_type": "B19",
            "mw": 2681.9,
            "gco2_per_kwh": 0
        },
        {
            "production_type": "B11",
            "mw": 2048.3,
            "gco2_per_kwh": 0
        },
        {
            "production_type": "B04",
            "mw": 811.5,
            "gco2_per_kwh": 450
        },
        {
            "production_type": "B17",
            "mw": 391.6,
            "gco2_per_kwh": 500
        },
        {
            "production_type": "B01",
            "mw": 284.3,
            "gco2_per_kwh": 230
        },
        {
            "production_type": "B12",
            "mw": 269.9,
            "gco2_per_kwh": 0
        },
        {
            "production_type": "B18",
            "mw": 120.2,
            "gco2_per_kwh": 0
        },
        {
            "production_type": "B25",
            "mw": 47.1,
            "gco2_per_kwh": 0
        },
        {
            "production_type": "B06",
            "mw": 34.2,
            "gco2_per_kwh": 750
        },
        {
            "production_type": "B10",
            "mw": 25.3,
            "gco2_per_kwh": 0
        }
    ]
}
Live Grid Intensity — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27331/live+grid+intensity?zone=FR' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Forward half-hourly GB grid carbon-intensity forecast (up to 48h).
Endpoint ID: 27332
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27332/grid+forecast
INPUT PARAMETERS

Grid Forecast — Endpoint Features

Object Description
zone Required Zone - GB only.
hours Optional Forecast horizon, up to 48.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

zone
hours
API EXAMPLE RESPONSE
JSON
{
    "zone": "GB",
    "hours": 24,
    "periods": [
        {
            "from": "2026-07-22T14:00Z",
            "to": "2026-07-22T14:30Z",
            "gco2_per_kwh": 85,
            "index": "low"
        },
        {
            "from": "2026-07-22T14:30Z",
            "to": "2026-07-22T15:00Z",
            "gco2_per_kwh": 84,
            "index": "low"
        },
        {
            "from": "2026-07-22T15:00Z",
            "to": "2026-07-22T15:30Z",
            "gco2_per_kwh": 86,
            "index": "low"
        },
        {
            "from": "2026-07-22T15:30Z",
            "to": "2026-07-22T16:00Z",
            "gco2_per_kwh": 92,
            "index": "moderate"
        },
        {
            "from": "2026-07-22T16:00Z",
            "to": "2026-07-22T16:30Z",
            "gco2_per_kwh": 106,
            "index": "moderate"
        },
        {
            "from": "2026-07-22T16:30Z",
            "to": "2026-07-22T17:00Z",
            "gco2_per_kwh": 132,
            "index": "moderate"
        },
        {
            "from": "2026-07-22T17:00Z",
            "to": "2026-07-22T17:30Z",
            "gco2_per_kwh": 152,
            "index": "moderate"
        },
        {
            "from": "2026-07-22T17:30Z",
            "to": "2026-07-22T18:00Z",
            "gco2_per_kwh": 166,
            "index": "moderate"
        },
        {
            "from": "2026-07-22T18:00Z",
            "to": "2026-07-22T18:30Z",
            "gco2_per_kwh": 172,
            "index": "high"
        },
        {
            "from": "2026-07-22T18:30Z",
            "to": "2026-07-22T19:00Z",
            "gco2_per_kwh": 182,
            "index": "high"
        },
        {
            "from": "2026-07-22T19:00Z",
            "to": "2026-07-22T19:30Z",
            "gco2_per_kwh": 193,
            "index": "high"
        },
        {
            "from": "2026-07-22T19:30Z",
            "to": "2026-07-22T20:00Z",
            "gco2_per_kwh": 197,
            "index": "high"
        },
        {
            "from": "2026-07-22T20:00Z",
            "to": "2026-07-22T20:30Z",
            "gco2_per_kwh": 205,
            "index": "high"
        },
        {
            "from": "2026-07-22T20:30Z",
            "to": "2026-07-22T21:00Z",
            "gco2_per_kwh": 210,
            "index": "high"
        },
        {
            "from": "2026-07-22T21:00Z",
            "to": "2026-07-22T21:30Z",
            "gco2_per_kwh": 212,
            "index": "high"
        },
        {
            "from": "2026-07-22T21:30Z",
            "to": "2026-07-22T22:00Z",
            "gco2_per_kwh": 211,
            "index": "high"
        },
        {
            "from": "2026-07-22T22:00Z",
            "to": "2026-07-22T22:30Z",
            "gco2_per_kwh": 208,
            "index": "high"
        },
        {
            "from": "2026-07-22T22:30Z",
            "to": "2026-07-22T23:00Z",
            "gco2_per_kwh": 200,
            "index": "high"
        },
        {
            "from": "2026-07-22T23:00Z",
            "to": "2026-07-22T23:30Z",
            "gco2_per_kwh": 197,
            "index": "high"
        },
        {
            "from": "2026-07-22T23:30Z",
            "to": "2026-07-23T00:00Z",
            "gco2_per_kwh": 195,
            "index": "high"
        },
        {
            "from": "2026-07-23T00:00Z",
            "to": "2026-07-23T00:30Z",
            "gco2_per_kwh": 192,
            "index": "high"
        },
        {
            "from": "2026-07-23T00:30Z",
            "to": "2026-07-23T01:00Z",
            "gco2_per_kwh": 191,
            "index": "high"
        },
        {
            "from": "2026-07-23T01:00Z",
            "to": "2026-07-23T01:30Z",
            "gco2_per_kwh": 186,
            "index": "high"
        },
        {
            "from": "2026-07-23T01:30Z",
            "to": "2026-07-23T02:00Z",
            "gco2_per_kwh": 176,
            "index": "high"
        },
        {
            "from": "2026-07-23T02:00Z",
            "to": "2026-07-23T02:30Z",
            "gco2_per_kwh": 163,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T02:30Z",
            "to": "2026-07-23T03:00Z",
            "gco2_per_kwh": 149,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T03:00Z",
            "to": "2026-07-23T03:30Z",
            "gco2_per_kwh": 132,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T03:30Z",
            "to": "2026-07-23T04:00Z",
            "gco2_per_kwh": 118,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T04:00Z",
            "to": "2026-07-23T04:30Z",
            "gco2_per_kwh": 109,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T04:30Z",
            "to": "2026-07-23T05:00Z",
            "gco2_per_kwh": 108,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T05:00Z",
            "to": "2026-07-23T05:30Z",
            "gco2_per_kwh": 119,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T05:30Z",
            "to": "2026-07-23T06:00Z",
            "gco2_per_kwh": 127,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T06:00Z",
            "to": "2026-07-23T06:30Z",
            "gco2_per_kwh": 147,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T06:30Z",
            "to": "2026-07-23T07:00Z",
            "gco2_per_kwh": 149,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T07:00Z",
            "to": "2026-07-23T07:30Z",
            "gco2_per_kwh": 152,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T07:30Z",
            "to": "2026-07-23T08:00Z",
            "gco2_per_kwh": 148,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T08:00Z",
            "to": "2026-07-23T08:30Z",
            "gco2_per_kwh": 142,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T08:30Z",
            "to": "2026-07-23T09:00Z",
            "gco2_per_kwh": 128,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T09:00Z",
            "to": "2026-07-23T09:30Z",
            "gco2_per_kwh": 122,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T09:30Z",
            "to": "2026-07-23T10:00Z",
            "gco2_per_kwh": 117,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T10:00Z",
            "to": "2026-07-23T10:30Z",
            "gco2_per_kwh": 114,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T10:30Z",
            "to": "2026-07-23T11:00Z",
            "gco2_per_kwh": 116,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T11:00Z",
            "to": "2026-07-23T11:30Z",
            "gco2_per_kwh": 118,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T11:30Z",
            "to": "2026-07-23T12:00Z",
            "gco2_per_kwh": 116,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T12:00Z",
            "to": "2026-07-23T12:30Z",
            "gco2_per_kwh": 115,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T12:30Z",
            "to": "2026-07-23T13:00Z",
            "gco2_per_kwh": 114,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T13:00Z",
            "to": "2026-07-23T13:30Z",
            "gco2_per_kwh": 114,
            "index": "moderate"
        },
        {
            "from": "2026-07-23T13:30Z",
            "to": "2026-07-23T14:00Z",
            "gco2_per_kwh": 116,
            "index": "moderate"
        }
    ]
}
Grid Forecast — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27332/grid+forecast?zone=GB&hours=24' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
The cleanest upcoming window (GB) to run a load, for carbon-aware load-shifting, with % savings vs the period average.
Endpoint ID: 27333
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27333/best+time+to+run
INPUT PARAMETERS

Best Time to Run — Endpoint Features

Object Description
duration Optional Load length in hours
within Optional Search horizon in hours (≤48).
zone Optional Zone - GB only

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

duration
within
zone
API EXAMPLE RESPONSE
JSON
{
    "zone": "GB",
    "duration_hours": 3,
    "within_hours": 24,
    "best_window": {
        "from": "2026-07-22T13:00Z",
        "to": "2026-07-22T16:00Z",
        "avg_gco2_per_kwh": 81.3,
        "index": "low"
    },
    "period_avg_gco2_per_kwh": 143.5,
    "savings_vs_average_pct": 43.3,
    "recommendation": "Run your 3.0h load starting 2026-07-22T13:00Z (UTC) - ~43.3% lower carbon than the 24h average."
}
Best Time to Run — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27333/best+time+to+run?duration=3&within=24&zone=GB' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Time-of-use-weighted CO₂e for an hourly kWh usage profile, using the GB forecast.
Endpoint ID: 27334
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27334/time-weighted+footprint
INPUT PARAMETERS

Time-weighted Footprint — Endpoint Features

Object Description
zone Optional Zone - GB Only.
profile Required Comma-separated hourly kWh, starting now.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

zone
profile
API EXAMPLE RESPONSE
JSON
{
    "zone": "GB",
    "hours": 4,
    "co2e_kg": 0.6491,
    "co2e_tonnes": 0.000649,
    "co2e_kg_if_flat_average": 0.6208,
    "note": "Time-of-use weighted using the GB forecast starting now.",
    "breakdown": [
        {
            "hour": 0,
            "kwh": 1.2,
            "gco2_per_kwh": 84.5,
            "co2e_kg": 0.1014
        },
        {
            "hour": 1,
            "kwh": 0.8,
            "gco2_per_kwh": 89,
            "co2e_kg": 0.0712
        },
        {
            "hour": 2,
            "kwh": 2,
            "gco2_per_kwh": 119,
            "co2e_kg": 0.238
        },
        {
            "hour": 3,
            "kwh": 1.5,
            "gco2_per_kwh": 159,
            "co2e_kg": 0.2385
        }
    ]
}
Time-weighted Footprint — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27334/time-weighted+footprint?zone=GB&profile=1.2,0.8,2.0,1.5' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
The valid categories, units, regions, years and grid regions — call this to discover valid inputs before building a request.
Endpoint ID: 27335
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27335/taxonomy
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{
    "categories": [
        {
            "factors": 49,
            "name": "Bioenergy"
        },
        {
            "factors": 28,
            "name": "Business travel- air"
        },
        {
            "factors": 168,
            "name": "Business travel- land"
        },
        {
            "factors": 3,
            "name": "Business travel- sea"
        },
        {
            "factors": 162,
            "name": "Delivery vehicles"
        },
        {
            "factors": 213,
            "name": "Electricity"
        },
        {
            "factors": 289,
            "name": "Freighting goods"
        },
        {
            "factors": 117,
            "name": "Fuels"
        },
        {
            "factors": 2,
            "name": "Heat and steam"
        },
        {
            "factors": 3,
            "name": "Homeworking"
        },
        {
            "factors": 39,
            "name": "Hotel stay"
        },
        {
            "factors": 1,
            "name": "Managed assets- electricity"
        },
        {
            "factors": 237,
            "name": "Managed assets- vehicles"
        },
        {
            "factors": 70,
            "name": "Material use"
        },
        {
            "factors": 156,
            "name": "Passenger vehicles"
        },
        {
            "factors": 359,
            "name": "Refrigerant & other"
        },
        {
            "factors": 63,
            "name": "Stationary Combustion"
        },
        {
            "factors": 2,
            "name": "Transmission and distribution"
        },
        {
            "factors": 1,
            "name": "UK electricity"
        },
        {
            "factors": 68,
            "name": "UK electricity T&D for EVs"
        },
        {
            "factors": 68,
            "name": "UK electricity for EVs"
        },
        {
            "factors": 2,
            "name": "WTT- UK electricity"
        },
        {
            "factors": 49,
            "name": "WTT- bioenergy"
        },
        {
            "factors": 28,
            "name": "WTT- business travel- air"
        },
        {
            "factors": 3,
            "name": "WTT- business travel- sea"
        },
        {
            "factors": 289,
            "name": "WTT- delivery vehs & freight"
        },
        {
            "factors": 114,
            "name": "WTT- fuels"
        },
        {
            "factors": 3,
            "name": "WTT- heat and steam"
        },
        {
            "factors": 168,
            "name": "WTT- pass vehs & travel- land"
        },
        {
            "factors": 134,
            "name": "Waste disposal"
        },
        {
            "factors": 2,
            "name": "Water supply"
        },
        {
            "factors": 2,
            "name": "Water treatment"
        }
    ],
    "grid_regions": [
        "ABW",
        "AFG",
        "AGO",
        "ARE",
        "ARG",
        "ARM",
        "ASM",
        "ATG",
        "AUS",
        "AUT",
        "AZE",
        "BDI",
        "BEL",
        "BEN",
        "BFA",
        "BGD",
        "BGR",
        "BHR",
        "BHS",
        "BIH",
        "BLR",
        "BLZ",
        "BMU",
        "BOL",
        "BRA",
        "BRB",
        "BRN",
        "BTN",
        "BWA",
        "CAF",
        "CAN",
        "CHE",
        "CHL",
        "CHN",
        "CIV",
        "CMR",
        "COD",
        "COG",
        "COK",
        "COL",
        "COM",
        "CPV",
        "CRI",
        "CUB",
        "CYM",
        "CYP",
        "CZE",
        "DEU",
        "DJI",
        "DMA",
        "DNK",
        "DOM",
        "DZA",
        "ECU",
        "EGY",
        "ERI",
        "ESH",
        "ESP",
        "EST",
        "ETH",
        "FIN",
        "FJI",
        "FLK",
        "FRA",
        "FRO",
        "GAB",
        "GBR",
        "GEO",
        "GHA",
        "GIB",
        "GIN",
        "GLP",
        "GMB",
        "GNB",
        "GNQ",
        "GRC",
        "GRD",
        "GRL",
        "GTM",
        "GUF",
        "GUM",
        "GUY",
        "HKG",
        "HND",
        "HRV",
        "HTI",
        "HUN",
        "IDN",
        "IND",
        "IRL",
        "IRN",
        "IRQ",
        "ISL",
        "ISR",
        "ITA",
        "JAM",
        "JOR",
        "JPN",
        "KAZ",
        "KEN",
        "KGZ",
        "KHM",
        "KIR",
        "KNA",
        "KOR",
        "KWT",
        "LAO",
        "LBN",
        "LBR",
        "LBY",
        "LCA",
        "LKA",
        "LSO",
        "LTU",
        "LUX",
        "LVA",
        "MAC",
        "MAR",
        "MDA",
        "MDG",
        "MDV",
        "MEX",
        "MKD",
        "MLI",
        "MLT",
        "MMR",
        "MNE",
        "MNG",
        "MOZ",
        "MRT",
        "MSR",
        "MTQ",
        "MUS",
        "MWI",
        "MYS",
        "NAM",
        "NCL",
        "NER",
        "NGA",
        "NIC",
        "NLD",
        "NOR",
        "NPL",
        "NRU",
        "NZL",
        "OMN",
        "PAK",
        "PAN",
        "PER",
        "PHL",
        "PNG",
        "POL",
        "PRI",
        "PRK",
        "PRT",
        "PRY",
        "PSE",
        "PYF",
        "QAT",
        "REU",
        "ROU",
        "RUS",
        "RWA",
        "SAU",
        "SDN",
        "SEN",
        "SGP",
        "SHN",
        "SLB",
        "SLE",
        "SLV",
        "SOM",
        "SPM",
        "SRB",
        "SSD",
        "STP",
        "SUR",
        "SVK",
        "SVN",
        "SWE",
        "SWZ",
        "SYC",
        "SYR",
        "TCA",
        "TCD",
        "TGO",
        "THA",
        "TJK",
        "TKM",
        "TLS",
        "TON",
        "TTO",
        "TUN",
        "TUR",
        "TWN",
        "TZA",
        "UGA",
        "UKR",
        "URY",
        "USA",
        "UZB",
        "VCT",
        "VEN",
        "VGB",
        "VIR",
        "VNM",
        "VUT",
        "WSM",
        "XKX",
        "YEM",
        "ZAF",
        "ZMB",
        "ZWE"
    ],
    "grid_years": [
        2000,
        2001,
        2002,
        2003,
        2004,
        2005,
        2006,
        2007,
        2008,
        2009,
        2010,
        2011,
        2012,
        2013,
        2014,
        2015,
        2016,
        2017,
        2018,
        2019,
        2020,
        2021,
        2022,
        2023,
        2024,
        2025
    ],
    "regions": [
        "ABW",
        "AFG",
        "AGO",
        "ARE",
        "ARG",
        "ARM",
        "ASM",
        "ATG",
        "AUS",
        "AUT",
        "AZE",
        "BDI",
        "BEL",
        "BEN",
        "BFA",
        "BGD",
        "BGR",
        "BHR",
        "BHS",
        "BIH",
        "BLR",
        "BLZ",
        "BMU",
        "BOL",
        "BRA",
        "BRB",
        "BRN",
        "BTN",
        "BWA",
        "CAF",
        "CAN",
        "CHE",
        "CHL",
        "CHN",
        "CIV",
        "CMR",
        "COD",
        "COG",
        "COK",
        "COL",
        "COM",
        "CPV",
        "CRI",
        "CUB",
        "CYM",
        "CYP",
        "CZE",
        "DEU",
        "DJI",
        "DMA",
        "DNK",
        "DOM",
        "DZA",
        "ECU",
        "EGY",
        "ERI",
        "ESH",
        "ESP",
        "EST",
        "ETH",
        "FIN",
        "FJI",
        "FLK",
        "FRA",
        "FRO",
        "GAB",
        "GB",
        "GBR",
        "GEO",
        "GHA",
        "GIB",
        "GIN",
        "GLP",
        "GMB",
        "GNB",
        "GNQ",
        "GRC",
        "GRD",
        "GRL",
        "GTM",
        "GUF",
        "GUM",
        "GUY",
        "HKG",
        "HND",
        "HRV",
        "HTI",
        "HUN",
        "IDN",
        "IND",
        "IRL",
        "IRN",
        "IRQ",
        "ISL",
        "ISR",
        "ITA",
        "JAM",
        "JOR",
        "JPN",
        "KAZ",
        "KEN",
        "KGZ",
        "KHM",
        "KIR",
        "KNA",
        "KOR",
        "KWT",
        "LAO",
        "LBN",
        "LBR",
        "LBY",
        "LCA",
        "LKA",
        "LSO",
        "LTU",
        "LUX",
        "LVA",
        "MAC",
        "MAR",
        "MDA",
        "MDG",
        "MDV",
        "MEX",
        "MKD",
        "MLI",
        "MLT",
        "MMR",
        "MNE",
        "MNG",
        "MOZ",
        "MRT",
        "MSR",
        "MTQ",
        "MUS",
        "MWI",
        "MYS",
        "NAM",
        "NCL",
        "NER",
        "NGA",
        "NIC",
        "NLD",
        "NOR",
        "NPL",
        "NRU",
        "NZL",
        "OMN",
        "PAK",
        "PAN",
        "PER",
        "PHL",
        "PNG",
        "POL",
        "PRI",
        "PRK",
        "PRT",
        "PRY",
        "PSE",
        "PYF",
        "QAT",
        "REU",
        "ROU",
        "RUS",
        "RWA",
        "SAU",
        "SDN",
        "SEN",
        "SGP",
        "SHN",
        "SLB",
        "SLE",
        "SLV",
        "SOM",
        "SPM",
        "SRB",
        "SSD",
        "STP",
        "SUR",
        "SVK",
        "SVN",
        "SWE",
        "SWZ",
        "SYC",
        "SYR",
        "TCA",
        "TCD",
        "TGO",
        "THA",
        "TJK",
        "TKM",
        "TLS",
        "TON",
        "TTO",
        "TUN",
        "TUR",
        "TWN",
        "TZA",
        "UGA",
        "UKR"
    ],
    "_note": "Response truncated for documentation purposes"
}
Taxonomy — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27335/taxonomy' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Return a single emission factor with full provenance and a data-quality tier.
Endpoint ID: 27336
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27336/get+factor+by+id
INPUT PARAMETERS

Get Factor by Id — Endpoint Features

Object Description
id Required The factor id.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

id
API EXAMPLE RESPONSE
JSON
{
    "activity": "bituminous",
    "activity_label": "Bituminous",
    "category": "Stationary Combustion",
    "co2e_kg_per_unit": 94.012,
    "gas_breakdown": {
        "ch4": 0.308,
        "co2": 93.28,
        "n2o": 0.424
    },
    "id": "epa-2025-stationary-bituminous",
    "path": "Stationary Combustion / Bituminous",
    "region": "US",
    "scope": 1,
    "unit": "mmBtu",
    "year": 2025,
    "data_quality": {
        "tier": "A",
        "score": 9,
        "max": 9,
        "basis": [
            "US federal government",
            "vintage 2025",
            "activity-specific"
        ],
        "note": "heuristic (authority x specificity x vintage); not statistical uncertainty"
    }
}
Get Factor by Id — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27336/get+factor+by+id?id=epa-2025-stationary-bituminous' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Year-over-year values for a factor (UK DEFRA 2023–2025) with the total change.
Endpoint ID: 27337
GET https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27337/factor+history
INPUT PARAMETERS

Factor History — Endpoint Features

Object Description
id Required The factor id.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

id
API EXAMPLE RESPONSE
JSON
{
    "id": "defra-2025-fuels-liquid-fuels-diesel-100-mineral-diesel-litres",
    "identity": "fuels-liquid-fuels-diesel-100-mineral-diesel-litres",
    "unit": "litres",
    "history": {
        "2023": 2.659372,
        "2024": 2.66155,
        "2025": 2.66155
    },
    "change_2023_to_latest": {
        "from_year": "2023",
        "to_year": "2025",
        "absolute": 0.002178,
        "percent": 0.08
    }
}
Factor History — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13267/carbon+footprint+and+emission+factor+api/27337/factor+history?id=defra-2025-fuels-liquid-fuels-diesel-100-mineral-diesel-litres' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Carbon Footprint and Emission Factor API simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

🚀 Enterprise Plan

Starts at
$ 10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

Turn any activity, spend, freight, or flight into kg CO₂e from open, sourced data (UK DEFRA, US EPA, Ember, IPCC) plus live grid carbon intensity for GB, US & EU and 213 countries.

Carbon Footprint and Emission Factor API FAQs

The Estimate CO2e endpoint returns data on carbon dioxide equivalent (CO₂e) emissions based on specified activities, including the amount, unit, region, year, and calculated emissions in kg and tonnes. It also provides emission factors with detailed provenance and data quality information.

Key fields in the response include "activity," "amount," "unit," "region," "year," "co2e_kg," "co2e_tonnes," and "factor." The "factor" object contains details like "id," "co2e_kg_per_unit," "source," and "data_quality."

Users can specify parameters such as "activity," "amount," "unit," "region," and "year" to customize their requests. Accepted values depend on the activity type and the region selected.

The response data is structured in JSON format, with the main emission data at the top level and a nested "factor" object containing detailed emission factor information, including source and quality metrics.

The data is sourced from reputable organizations such as UK DEFRA, US EPA, Ember, and IPCC. Each emission factor includes its source, year, and license, ensuring transparency and reliability.

Data accuracy is maintained through rigorous sourcing from authoritative bodies and a transparent data-quality tier system. Each factor is assessed for its reliability based on authority, specificity, and vintage.

Typical use cases include carbon accounting for businesses, sustainability reporting, and environmental impact assessments. Users can estimate emissions from various activities like transportation, energy use, and material consumption.

Users can leverage the returned data to calculate their carbon footprint, compare emissions across different activities, and make informed decisions for reducing their environmental impact based on accurate emission factors.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs