Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: emission-factors.com Bulk API
version: 2.1.0
description: 'US electricity and fuel emission data by ZIP code: EPA eGRID Scope 2 factors (location-based) with the Green-e residual mix (market-based), Scope 1 fuel factors, EIA retail rates and hourly grid intensity, EPA CAMD plant emissions and OpenEI utility tariffs. Free, no key. Query parameters and JSON body fields not listed here are rejected with 400.'
contact:
url: https://emission-factors.com
license:
name: 'Data licenses vary by source: US government works (public domain); eGRID2024, GHG Hub 2026, OpenEI URDB and ZIP-to-utility data, and GeoNames are CC-BY-4.0; the Green-e residual mix is published by the Center for Resource Solutions. See /methodology.'
url: https://emission-factors.com/methodology
servers:
- url: https://emission-factors.com
description: Production
tags:
- name: Bulk
paths:
/api/bulk:
post:
summary: Process a CSV file of ZIP codes
operationId: bulk
requestBody:
required: true
content:
text/csv:
schema:
type: string
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
responses:
'200':
description: Enriched CSV with emission factor columns. Delimiter (comma, semicolon, tab) is detected from the header; the ZIP and kWh columns are detected by name (X-kWh-Column-Detected header).
'400':
description: No CSV, or no ZIP column
'413':
description: Over 1 MB
tags:
- Bulk