Flight: EPA 🇺🇸
Calculate passenger flight emissions with the US EPA GHG Emission Factors Hub, pinned to a Hub year or using the latest supported one.
The US Environmental Protection Agency (EPA) methodology for passenger flights covers direct emissions and takes into account elements such as plane type, flight distance, fuel efficiency and load factors.
Versioning
Include methodology_version to pin a specific Hub year (for example "2024"). If you leave it out, SQUAKE uses the latest supported year.
Sample requests
Send a quote while the traveller is still choosing a flight, then repeat the call with audit set to true once the booking is final. The body is otherwise identical.
{
"expand": ["items"],
"items": [{
"audit": false,
"type": "flight",
"methodology": "US-EPA",
"external_reference": "test_1",
"number_of_travelers": 1,
"origin": "JFK",
"destination": "ORY",
"methodology_version": "2024"
}]
}audit_for is optional
Pass the ID of an auditable entity when you calculate on behalf of that entity. Otherwise, leave it out.
Request fields
typestringrequiredflight
methodologystringrequiredUS-EPA
methodology_versionstringEPA Hub year, for example "2024". Optional. If you leave it out, SQUAKE uses the latest supported year.
originstringIATA/ICAO airport code (MUC), UN/LOCODE for other locations (DEHAM), or latitude and longitude (+40.712,-74.006). For multi-leg trips, use routing instead.
destinationstringSame formats as origin.
routingstringHyphen-separated airports for multi-leg itineraries, instead of origin and destination. See Flight: Routing (multi-leg).
distance_in_kmnumberOverrides the distance resolved from origin and destination. With routing, it isn't used as the routed total.
number_of_travelersintegerMinimum 1. Defaults to 1.
external_referencestringYour identifier for matching requests to responses, up to 128 characters.
sustainable_fuelsbooleanMarks the use of sustainable aviation fuel (SAF). This lowers the emissions SQUAKE calculates, but isn't part of the EPA factors.
carbon_reduction_percentage_of_totalnumberShare of emissions reduced when sustainable_fuels is used, from 0 to 1. Defaults to 0.
auditbooleanSet to true to create immutable audit records for finalised calculations. Must be enabled for your account.
POST /v2/calculations in the API referenceMode-level factors
EPA provides mode-level factors. Aircraft-specific parameters (type, booking class, RFI) aren't part of the EPA Hub factors.
Sample response
{
"carbon_quantity": 625550,
"carbon_unit": "gram",
"items": [{
"carbon_quantity": 625550,
"carbon_unit": "gram",
"external_reference": "test_1",
"type": "flight",
"methodology": "US-EPA",
"methodology_version": "2024",
"distance": 5964.0,
"distance_unit": "kilometer"
}]
}Versions
If methodology_version is left out, SQUAKE applies the latest supported EPA Hub year. Pin a year for reproducibility and auditability.
Bibliography
US EPA. GHG Emission Factors Hub. epa.gov