Household sustainability score (0-100) API

Transparent 0-100 household sustainability rubric with documented weights: totalFootprint 45% (linear, 0 t=100 / 12 t=0, anchored to the ~2 t/person sustainable target), renewableShare 20%, transportShare 15% (cap 5 t), dietShare 10% (cap 3 t), recyclingRate 10%. Returns the score, an A-F rating, an interpretation and a per-factor breakdown with weights and contributions. Answers 'rate my carbon footprint','sustainability grade for 8 tonnes','how green is my lifestyle','score my household emissions'.

Price$0.01per request

MethodPOST

Route/v1/calc/carbon-footprint-score

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

carbonscoresustainabilityfootprintrubricratinghouseholdesg

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

Integration docs

Example request

{
  "annualTonnesCO2e": 8,
  "renewablePercent": 30,
  "recyclesPercent": 50
}

Example response

{
  "annualTonnesCO2e": 8,
  "score": 39.8,
  "rating": "D",
  "interpretation": "above sustainable target — high impact",
  "breakdown": [
    {
      "factor": "totalFootprint",
      "weight": 0.45,
      "value": 0.333,
      "contribution": 15
    },
    {
      "factor": "renewableShare",
      "weight": 0.2,
      "value": 0.3,
      "contribution": 6
    },
    {
      "factor": "transportShare",
      "weight": 0.15,
      "value": 0.52,
      "contribution": 7.8
    },
    {
      "factor": "dietShare",
      "weight": 0.1,
      "value": 0.6,
      "contribution": 6
    },
    {
      "factor": "recyclingRate",
      "weight": 0.1,
      "value": 0.5,
      "contribution": 5
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "annualTonnesCO2e"
  ],
  "properties": {
    "annualTonnesCO2e": {
      "type": "number",
      "examples": [
        8
      ]
    },
    "renewablePercent": {
      "type": "number",
      "description": "% of energy from renewables",
      "examples": [
        30
      ]
    },
    "transportTonnes": {
      "type": "number"
    },
    "dietTonnes": {
      "type": "number"
    },
    "recyclesPercent": {
      "type": "number",
      "examples": [
        50
      ]
    }
  }
}

Output schema

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