# Hotel: GreenView

💡 **High-Level Description**

The **GreenView Hotel Footprinting Tool (HFT)** is a robust, industry-recognized dataset that provides carbon footprint coefficients for hotel stays and meeting spaces worldwide. It is based on the **Cornell Hotel Sustainability Benchmarking Index (CHSB)** data, offering more granularity and updated figures.

The GreenView HFT dataset:

* Covers \~200 countries, 100 sub-national regions, and 450 market areas.
* Includes coefficients segmented by hotel star rating (2–5 stars) and hotel average.
* Is updated annually and adapted from the latest CHSB dataset.
* Is intended for integration into hotel emissions calculations and sustainability reporting.

GreenView HFT enables Online Booking Tools (OBTs), Travel Management Companies (TMCs), Online Travel Agencies (OTAs), and other stakeholders to calculate and communicate hotel emissions with improved accuracy and transparency.

**Versioning:** Add `methodology_version` to pin a specific GreenView HFT dataset year (e.g., `"2024"`). If omitted, SQUAKE **uses the latest supported year**.

***

### Sample API Requests

#### A. Without audit mode (for pre-booking/quotes)

```json
{
  "expand": ["items"],
  "items": [
    {
      "audit": false,
      "type": "hotel",
      "methodology": "GREENVIEW",
      "external_reference": "string",
      "country": "AU",
      "city": "Sydney",
      "stars": 4,
      "number_of_nights": 1,
      "methodology_version": "2024"
    }
  ]
}
```

#### B. With audit mode (for finalized/post-booking calculations)

```json
{
  "expand": ["items"],
  "audit_for": "<Auditable Entity ID>",
  "items": [
    {
      "audit": true,
      "type": "hotel",
      "methodology": "GREENVIEW",
      "external_reference": "string",
      "country": "AU",
      "city": "Sydney",
      "stars": 4,
      "number_of_nights": 1,
      "methodology_version": "2024"
    }
  ]
}
```

> **Note:** `audit_for` is optional. Provide when calculating on behalf of a specific Auditable entity; otherwise omit.

***

### API Request Items

* `"type"`: `"hotel"` (required)
* `"methodology"`: `"GREENVIEW"` (required)
* `"methodology_version"`: GreenView HFT dataset year (`"2021"` – `"2026"`). **Optional**; if omitted → **latest supported year**.
* `"external_reference"`: A unique identifier that helps link the resulting emissions to the requested item. Maximum length: 128 characters.
* `"country"`: ISO-2 or 3 code of the country.
* `"city"`: Full city name. The full list of the supported cities is [here](https://squake.notion.site/237754e0050481838a1deea7dc0a7ba0?v=237754e00504812aba8d000c4b480cf4\&source=copy_link).
* `"state"`: Full state name. The full list of the supported states is [here](https://squake.notion.site/237754e005048191a59ef561244c09b0?v=237754e0050481758081000c23e8e4dd\&source=copy_link).
* `"stars"`: Hotel star rating from 1 to 5. If unavailable or unsupported for a specific location, falls back to hotel average.
* `"number_of_nights"`: Number of nights. Minimum value: 1.
* `"audit"`: boolean (optional). Set to `true` to create immutable audit records for finalized calculations. Must be enabled for your account.

***

### Default values

* `"methodology_version"`: **latest supported GreenView year**

***

### Default Logic

📍 **Location hierarchy**

1. If `city` data is unavailable → fallback to `state`.
2. If `state` data is unavailable → fallback to `country`.
3. If `country` data is unavailable → fallback to `continent`.

⭐ **Stars fallback**

1. If data for specified `stars` is unavailable → fallback to `hotel_average`.
2. If no `stars` are passed → use `hotel_average`.
3. If no location is known → default to `32.69` kgCO₂e per night.

***

### Sample API Response

```json
{
    "carbon_quantity": 16193,
    "carbon_unit": "gram",
    "items": [
        {
            "carbon_quantity": 16193,
            "carbon_unit": "gram",
            "external_reference": "string",
            "type": "hotel",
            "methodology": "GREENVIEW",
            "methodology_version": "2024"
        }
    ]
}
```

***

### Versions

* **Supported range:** `2021` – `2026`
* **Behavior:** If `methodology_version` is omitted, SQUAKE automatically applies the **latest supported** GreenView HFT year. Pin a specific year for reproducibility and auditability.

***

### Notes

* Use the following citation when using the dataset:

  > *Greenview Hotel Footprinting Tool Version 2024v1.1 (adapted from CHSB2024 data set of 2022 calendar year data).*

If the data is modified or adjusted, include a clear note in the citation.

***

## Bibliography

* Greenview. *Hotel Footprinting Tool Version 2024*. Greenview Hospitality Pte. Ltd., adapted from CHSB 2024.
* Ricaurte, Eric. *Hotel Sustainability Benchmarking Index 2024: Carbon, Energy, and Water*. Cornell University, 2024.