Copy page

Estimation APIs

Emissions from Hotel Stay

Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) based on country of hotel, length of stay, room count, and hotel star rating.

CarbonSutra's approach for calculating the carbon footprint of hotel stays is based on Cornell Hotel Sustainability Benchmark Index and UK government's GHG conversion factors published in 2026.

operationId: calculate_emissions_from_hotel_stay

Payload Specification

Field	Type	Required	Default	Description	Example
country_code	String	Yes	-	Two digit ISO 3166-1 alpha-2 country code. Allowed: [ae , ar , at , au , be , ca , ch , cn , co , cr , cz , de , do , eg , es , fr , gb , gr , hk , id , in , it , jp , kr , mx , my , nl , pa , pl , pr , pt , qa , sa , sg , th , tr , tw , us , vn , za]	us
city_name	String	No	-	City of hotel within the country	Chicago
hotel_rating	Number	No	4	Expedia star rating classification of the hotel. Allowed: [2-5]	5
number_of_nights	Number	No	1	Length of stay in nights	3
number_of_rooms	Number	No	1	Number of rooms booked, irrespective of count of persons per room	1
cluster_name	String	No	-	Identifier to log and aggregate these results under using the Cluster Data API	KrugerBrent_ID701_Jun26

Example

Request Payload

Code
import http.client
conn = http.client.HTTPSConnection("carbonsutra1.p.rapidapi.com")
payload = "country_code=IN&city_name=MUMBAI&hotel_rating=4&number_of_nights=3&number_of_rooms=1"
headers = {
    'content-type': "application/x-www-form-urlencoded",
    'Authorization': "Bearer <AUTHORIZATION_TOKEN>",
    'X-RapidAPI-Key': "<AUTHORIZATION_KEY>",
    'X-RapidAPI-Host': "carbonsutra1.p.rapidapi.com"
    }
conn.request("POST", "/hotel_estimate", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Response Payload

Code
{
  "data": {
    "type": "estimate-hotel-stay",
    "country": "India",
    "city_name": "Mumbai",
    "hotel_rating": "4",
    "number_of_nights": "3",
    "number_of_rooms": "1",
    "co2e_gm": 182160,
    "co2e_kg": 182.16,
    "co2e_mt": 0.18,
    "co2e_lb": 401.59,
    "explanation": "CarbonSutra uses the Cornell Hotel Sustainability Benchmarking Index 2026 (CHSB2026) for this calculation, specifically leveraging the mean value from the CHSB validity test for Measure 1 - HCMI Room Night Emission (Carbon Category). Because specific emission factors for Mumbai are unlisted in CHSB2026, fallback data for India has been applied to this calculation of one room and 3 nights. This methodology relies on the Expedia Star Rating classification system. Where regional data gaps exist, proxy assignments are made according to the transparent governance rules published on carbonsutra.com. For the hotel rating of four stars, an emission factor of 60.72 kgCO2e per room night is used. This footprint evaluates to 182,160 grams of CO2e. Standardized unit conversions render this as 182.16 kg (rounded to two decimal places) or 0.18 metric tons. Scaled against imperial baselines using the conversion factor of 2.20462 (source: GHG conversion factors, 2026), the final metric is expressed as 401.59 lbs. "
  },
  "success": true,
  "status": 200
}

Countries (and COUNTRY_CODE) supported by API:

Argentina(AR), Australia(AU), Austria(AT), Belgium(BE), Canada(CA), China(CN), Colombia(CO), Costa Rica(CR), Czech Republic(CZ), Dominican Republic(DO), Egypt(EG), France(FR), Germany(DE), Greece(GR), Hong Kong(HK), India(IN), Indonesia(ID), Italy(IT),Japan(JP), Korea(KR), Malaysia(MY), Mexico(MX), Netherlands(NL), Panama(PA), Poland(PL), Portugal(PT), Puerto Rico(PR), Qatar(QA), Saudi Arabia(SA), Singapore(SG), South Africa(ZA), Spain(ES), Switzerland(CH), Taiwan(TW), Thailand(TH), Turkey(TR), United Arab Emirates(AE), United Kingdom(GB), United States of America(US) and Vietnam(VN).

Notes on Star Ratings:

From CHSB 2026 Index, only the star classification is used. It refers to the Expedia star rating. Not all countries have all stars. CarbonSutra transparently uses the following set of rules:

• If 5 star is selected but is absent in database for that country, then the maximum value of any other star category for that country is used.
• If 4 star is selected but it is absent in database, it is considered as 5 star.
• If 3 star is selected but it is absent in database, it is considered as 4 star.
• If 2 star is selected but it is absent in database, it is considered as 4 star.
• If no star is selected (as it is optional), the average emission factor of all other stars for that country is used.