{"title":"EPA eGRID ZIP Factor API Methodology","version":{"ID":"eGRID2023-Rev2","YEAR":"2023","RELEASE_DATE":"2025-06-12","RELEASE_LABEL":"June 2025","SHORT_NAME":"eGRID2023 Rev2","FULL_NAME":"eGRID2023 Rev2 (2025-06-12)","NEXT_PLANNED":"eGRID2024 (preliminary available via ?year=2024 - official EPA release pending)","UPDATE_FREQUENCY":"Annual"},"description":"This API provides electricity emission factors for U.S. ZIP codes based on EPA eGRID data.","scope":"Location-based Scope 2 factors via EPA eGRID subregion averages (GHG Protocol Scope 2: location-based)","data_source":{"name":"EPA eGRID","edition":"eGRID2023 Rev2 (2025-06-12)","url":"https://www.epa.gov/egrid","summary_data":"https://www.epa.gov/egrid","download_links":{"summary_tables_pdf":"https://www.epa.gov/egrid","summary_tables_xlsx":"https://www.epa.gov/egrid"}},"mapping_methodology":{"description":"ZIP codes mapped to eGRID subregions using Census ZCTA centroids","zcta_note":"ZCTAs are Census approximations of USPS ZIP service areas. ZCTAs ≠ USPS ZIPs: ZCTAs are generalized areal representations of ZIP code service areas.","approximation_note":"EPA eGRID boundaries are representational/approximate and may not align perfectly with other geographic datasets.","census_guidance":"https://www.census.gov/programs-surveys/geography/guidance/geo-areas/zctas.html"},"endpoints":{"/api/lookup":"Get emission factors for a single ZIP code","/api/bulk":"Process multiple ZIP codes via CSV upload","/health":"Service health check","/probe":"Comprehensive service validation","/methodology":"API documentation and methodology"},"units":{"source":"lb/MWh (EPA native)","api_default":"kg/kWh","conversion":"kg/kWh = lb/MWh × 0.45359237 / 1000"},"edition_policy":{"current":"eGRID2023 Rev2 (2025-06-12)","next_planned":"eGRID2024 (preliminary available via ?year=2024 - official EPA release pending)","update_frequency":"Annually (EPA releases new eGRID data each year)","backwards_compatibility":"API maintains consistent response format across editions"},"attribution":"Data derived from EPA eGRID 2023 database"}