Home energy CO2 footprint API

Compute household CO2e from electricity (kWh x grid intensity), natural gas (therms x 5.3 kg/therm, EPA) and heating oil (litres x 2.52 kg/L), summed and annualized from a monthly or yearly period. Returns a per-source breakdown, total and annual kg/tonnes CO2e and tree equivalents. Answers 'CO2 of my home energy bill','footprint of 900 kWh and 50 therms','annual heating emissions','electricity vs gas carbon split'.

Price$0.01per request

MethodPOST

Route/v1/calc/carbon-home-energy-footprint

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

carbonhomeenergyelectricitygasemissionsco2footprint

API URLhttps://x402.hexl.dev/v1/calc/carbon-home-energy-footprint

Integration docs

Example request

{
  "electricityKwh": 900,
  "naturalGasTherms": 50,
  "period": "month"
}

Example response

{
  "period": "month",
  "electricityKwh": 900,
  "gridKgCO2PerKwh": 0.4,
  "naturalGasTherms": 50,
  "heatingOilLitres": 0,
  "breakdown": [
    {
      "source": "electricity",
      "kgCO2e": 360
    },
    {
      "source": "naturalGas",
      "kgCO2e": 265
    },
    {
      "source": "heatingOil",
      "kgCO2e": 0
    }
  ],
  "totalKgCO2e": 625,
  "annualKgCO2e": 7500,
  "annualTonnesCO2e": 7.5,
  "equivalentTrees": 357.14
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "electricityKwh": {
      "type": "number",
      "examples": [
        900
      ]
    },
    "gridKgCO2PerKwh": {
      "type": "number",
      "default": 0.4
    },
    "naturalGasTherms": {
      "type": "number",
      "examples": [
        50
      ]
    },
    "heatingOilLitres": {
      "type": "number",
      "default": 0
    },
    "period": {
      "type": "string",
      "enum": [
        "month",
        "year"
      ],
      "default": "year"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}