Look up emission factors for a ZIP code

get/api/lookup

Request

  • Base URL: https://emission-factors.com
  • URL: https://emission-factors.com/api/lookup
  • Auth: none declared

Query parameters

zipstring required

5-digit ZIP; ZIP+4 accepted

year'2023' | '2024'

2024 = eGRID2024 from Cornerstone (EPA code, 2024 inputs; CC-BY-4.0); residual mix only with 2023

Response

Emission factors for the ZIP code. A well-formed ZIP with no eGRID mapping (PO box, territory) returns 200 with candidates: [] and the reason in notes.

zipstring
notesstring
edition_notestring

Which eGRID edition was used. For the default (2023) it also gives how eGRID2024 differs and the GWP basis (eGRID CO2e uses AR5); for year=2024 it gives the provenance and that the residual mix needs 2023.

Example response

{
  "candidates": [
    {
      "subregion": "CAMX",
      "co2e_kg_per_kwh": 0.195037,
      "co2e_lb_per_mwh": 429.983,
      "co2_kg_per_kwh": 0.194348,
      "co2_lb_per_mwh": 428.464,
      "residual_mix_co2e_kg_per_kwh": 0.196958,
      "residual_mix_co2e_lb_per_mwh": 434.219,
      "ch4_kg_per_kwh": 0.00001134,
      "ch4_lb_per_mwh": 0.025,
      "n2o_kg_per_kwh": 0.00000136,
      "n2o_lb_per_mwh": 0.003,
      "co2_nonbaseload_kg_per_kwh": 0.434679,
      "co2_nonbaseload_lb_per_mwh": 958.303,
      "nox_lb_per_mwh": 0.332,
      "nox_kg_per_kwh": 0.00015059,
      "so2_lb_per_mwh": 0.02,
      "so2_kg_per_kwh": 0.00000907,
      "carbon_free_pct": 54.34,
      "renewable_pct": 46.36,
      "data_year": "eGRID2023 Rev2 (2025-06-12)"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.