# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-integration.squake.earth/api-calculations-request-response/travel/hotel/hotel-greenview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.