# Green Web Foundation

> Check whether a website runs on green hosting, using the Green Web Foundation's dataset of hosting providers it has verified as running on green energy: which company hosts the site, and the evidence behind its claim. Check up to 25 sites at once, find the carbon intensity and fossil fuel share of the electricity grid in the country behind an IP address, and browse the directory of verified green hosting providers by country, with their data centres. No account or API key required.

App · 5 actions. Web page: https://docs.lodol.com/docs/integrations/green-web-foundation

## Actions

### Check a website

Find out whether a website runs on green hosting: whether it is served by a hosting provider the Green Web Foundation has verified as running on green energy, which provider that is, and the reports and certificates the provider shared as evidence. Give a domain, a full web address or an IP address. A site that isn't on green hosting comes back with 'green' set to false rather than failing the step. No API key required.

**Inputs**

- Website (`website`, text, required): The site to check: its domain (example.com), a full web address (https://www.example.com/about), or an IP address. Only the host is checked, so a path or a page makes no difference. www.example.com and example.com are checked separately, because they can be served from different places.
- Fresh check (`fresh_check`, true/false): Turn on to look the site up again now instead of reading the Green Web Foundation's saved result, for instance just after moving the site to a new host. It takes a few seconds longer. Default: `false`.

**Outputs**

- `checked_at` (text): When the Green Web Foundation last checked the site, in UTC, e.g. '2026-10-20T04:44:05Z'.
- `green` (true/false): True when the site is served by a hosting provider the Green Web Foundation has verified as running on green energy. False (a 'grey' result) when it isn't, or the host isn't known.
- `hosted_by` (text): The green hosting provider serving the site, e.g. 'Cloudflare'. Empty for a grey result.
- `hosting_provider_id` (number): The Green Web Foundation's id for that hosting provider, which 'Get a hosting provider' reads. Empty for a grey result.
- `hosting_provider_website` (text): The hosting provider's website. Empty for a grey result.
- `listed_in_directory` (true/false): True when the hosting provider appears in the Green Web Foundation's public directory of green hosts.
- `partner` (text): The hosting provider's partner level with the Green Web Foundation, e.g. 'Gold Partner'. Empty for most.
- `report_url` (text): The Green Web Foundation's own results page for this site, to share with someone.
- `summary` (text): One line with the verdict, e.g. 'example.com runs on green hosting from Cloudflare.'
- `supporting_documents` (list): The evidence the hosting provider shared to back its green claim: reports, certificates and statements. Empty for a grey result.
- `website` (text): The host that was checked, e.g. 'example.com': the domain or IP address given, without https:// or a path.

**Example output**

```json
{
  "checked_at": "2026-10-20T04:44:05Z",
  "green": true,
  "hosted_by": "Cloudflare",
  "hosting_provider_id": 779,
  "hosting_provider_website": "https://www.cloudflare.com",
  "listed_in_directory": true,
  "partner": null,
  "report_url": "https://www.thegreenwebfoundation.org/green-web-check/?url=example.com",
  "summary": "example.com runs on green hosting from Cloudflare.",
  "supporting_documents": [
    {
      "id": 18,
      "link": "https://blog.cloudflare.com/the-climate-and-cloudflare/",
      "title": "Blog post - The Climate and Cloudflare"
    },
    {
      "id": 1264,
      "link": "https://media.greenweb.org/uploads/Cloudflare_2023_Emissions_Inventory.pdf",
      "title": "Cloudflare 2023 Emissions Inventory"
    },
    {
      "id": 2532,
      "link": "https://media.greenweb.org/uploads/Impact-Report-2025_01282026.pdf",
      "title": "2025 Impact Report"
    }
  ],
  "website": "example.com"
}
```

### Check several websites

Check up to 25 websites for green hosting in one step, such as a list of suppliers' or clients' sites. Each comes back in the order given with its verdict, its hosting provider and the provider's evidence, plus how many are green and whether all of them are. No API key required.

**Inputs**

- Websites (`websites`, list, required): Up to 25 sites to check: domains, web addresses or IP addresses. A list from an earlier step works, and so does text with one site per line or separated by commas. A site given twice is checked once.

**Outputs**

- `all_green` (true/false): True when every website checked is green.
- `count` (number): How many websites were checked.
- `green_count` (number): How many of them run on verified green hosting.
- `grey_count` (number): How many of them don't.
- `results` (list): One green check per website, in the order given, with repeats checked once.
- `summary` (text): One line with the tally, e.g. '2 of 3 websites run on verified green hosting.'

**Example output**

```json
{
  "all_green": false,
  "count": 2,
  "green_count": 1,
  "grey_count": 1,
  "results": [
    {
      "checked_at": "2026-10-20T04:44:05Z",
      "green": true,
      "hosted_by": "Cloudflare",
      "hosting_provider_id": 779,
      "hosting_provider_website": "https://www.cloudflare.com",
      "listed_in_directory": true,
      "partner": null,
      "report_url": "https://www.thegreenwebfoundation.org/green-web-check/?url=example.com",
      "summary": "example.com runs on green hosting from Cloudflare.",
      "supporting_documents": [
        {
          "id": 18,
          "link": "https://blog.cloudflare.com/the-climate-and-cloudflare/",
          "title": "Blog post - The Climate and Cloudflare"
        },
        {
          "id": 1264,
          "link": "https://media.greenweb.org/uploads/Cloudflare_2023_Emissions_Inventory.pdf",
          "title": "Cloudflare 2023 Emissions Inventory"
        },
        {
          "id": 2532,
          "link": "https://media.greenweb.org/uploads/Impact-Report-2025_01282026.pdf",
          "title": "2025 Impact Report"
        }
      ],
      "website": "example.com"
    },
    {
      "checked_at": "2026-10-22T07:08:30Z",
      "green": false,
      "hosted_by": null,
      "hosting_provider_id": null,
      "hosting_provider_website": null,
      "listed_in_directory": false,
      "partner": null,
      "report_url": "https://www.thegreenwebfoundation.org/green-web-check/?url=wikipedia.org",
      "summary": "wikipedia.org is not on a hosting provider the Green Web Foundation has verified as green.",
      "supporting_documents": [],
      "website": "wikipedia.org"
    }
  ],
  "summary": "1 of 2 websites runs on verified green hosting."
}
```

### Get a hosting provider

Get one hosting provider's record from the Green Web Foundation: its website and country, how it covers its energy use (green energy, compensation or a mix), and the data centres it listed with their city and energy efficiency. Pick the provider, or use the id a website check returned. No API key required.

**Inputs**

- Hosting provider (`hosting_provider`, text, required): Pick a provider from the Green Web Foundation's directory, or use the hosting provider id a website check or the provider list returned, such as 779 for Cloudflare.

**Outputs**

- `country_code` (text): The two-letter code of the provider's country.
- `country_name` (text): The provider's country, e.g. 'Belgium'.
- `data_centre_count` (number): How many data centres are listed.
- `data_centres` (list): The data centres the provider told the Green Web Foundation about. Many providers list none.
- `energy_model` (text): How the provider covers its energy use, as the Green Web Foundation recorded it: 'green_energy' (it runs on green energy), 'compensation' (it compensates for its energy use) or 'mixed'.
- `energy_model_label` (text): The energy model in words, e.g. 'Runs on green energy'.
- `id` (number): The Green Web Foundation's id for the provider.
- `name` (text): The provider's name, e.g. 'Combell'.
- `partner` (text): The provider's partner level with the Green Web Foundation, e.g. 'Gold Partner'. Empty for most.
- `summary` (text): One line about the provider, e.g. 'Combell (Belgium): runs on green energy, 2 data centres listed.'
- `website` (text): The provider's website address, without https://, e.g. 'www.combell.com'.

**Example output**

```json
{
  "country_code": "BE",
  "country_name": "Belgium",
  "data_centre_count": 2,
  "data_centres": [
    {
      "certificates": [],
      "city": "Diegem",
      "country_code": "BE",
      "country_name": "Belgium",
      "energy_model": "green_energy",
      "id": 19,
      "name": "LCL Diegem",
      "pue": 1.6,
      "website": "http://www.lcl.be"
    },
    {
      "certificates": [],
      "city": "Zaventem",
      "country_code": "BE",
      "country_name": "Belgium",
      "energy_model": "green_energy",
      "id": 58,
      "name": "Interxion - Brussels (BRU4)",
      "pue": 1.25,
      "website": "http://www.interxion.com"
    }
  ],
  "energy_model": "green_energy",
  "energy_model_label": "Runs on green energy",
  "id": 198,
  "name": "Combell",
  "partner": null,
  "summary": "Combell (Belgium): runs on green energy, 2 data centres listed.",
  "website": "www.combell.com"
}
```

### Get grid carbon intensity

Find how carbon intensive the electricity is where a server is: give its IP address and get the country it is located in, the grams of CO2 emitted per kilowatt-hour on that country's grid, averaged over a year, and the share of its electricity made from fossil fuels. The figures come from the energy think tank Ember and are useful for estimating a website's or service's emissions. No API key required.

**Inputs**

- IP address (`ip_address`, text, required): A public IPv4 or IPv6 address, such as a web server's. The figures are for the country it is located in. An address shared around the world, such as 1.1.1.1, can't be placed and gets the world average.

**Outputs**

- `carbon_intensity` (number): Grams of CO2 emitted per kilowatt-hour of electricity on that country's grid, averaged over the year, e.g. 388.186. Lower is cleaner.
- `country_code` (text): The country's two-letter code, e.g. 'NL'. Empty when the address couldn't be placed.
- `country_code_alpha3` (text): The country's three-letter code, e.g. 'NLD'. Empty when the address couldn't be placed.
- `country_name` (text): The country's name, e.g. 'Netherlands', or 'World' for the world average.
- `fossil_share_percent` (number): The percentage of the country's electricity generated from fossil fuels that year, e.g. 69.84.
- `intensity_type` (text): 'average': the figure is the grid's average intensity over the year, the measure most carbon reporting uses.
- `ip_address` (text): The IP address that was looked up.
- `located` (true/false): True when the address was placed in a country. False when it couldn't be (an address shared worldwide, such as 1.1.1.1), in which case every figure is the world average.
- `summary` (text): One line with the country and its figures.
- `year` (number): The year the figures describe, e.g. 2021.

**Example output**

```json
{
  "carbon_intensity": 388.186,
  "country_code": "NL",
  "country_code_alpha3": "NLD",
  "country_name": "Netherlands",
  "fossil_share_percent": 69.84,
  "intensity_type": "average",
  "ip_address": "193.0.6.139",
  "located": true,
  "summary": "Netherlands, for 193.0.6.139: 388 g CO2 per kWh on average in 2021, with 69.8% of electricity from fossil fuels.",
  "year": 2021
}
```

### List green hosting providers

List the hosting providers in the Green Web Foundation's directory of verified green hosts, with each one's website and country. Narrow it to one country, or to names containing some text, to find a green host to move a site to. No API key required.

**Inputs**

- Country (`country`, text): List only the providers based in this country. Leave it empty for every country. Most providers are in Europe and North America. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 240 more.
- Name contains (`name`, text): List only the providers whose name or website contains this text, e.g. 'cloud'. Capitals don't matter.

**Outputs**

- `count` (number): How many providers matched.
- `country_code` (text): The country the list was narrowed to, as its two-letter code. Empty when every country was listed.
- `country_name` (text): The name of the country the list was narrowed to. Empty when every country was listed.
- `providers` (list): Every matching provider, grouped by country, partners first and then by name.
- `summary` (text): One line saying how many providers matched, e.g. 'Netherlands: 2 green hosting providers listed, matching 'cloud'.'

**Example output**

```json
{
  "count": 2,
  "country_code": "NL",
  "country_name": "Netherlands",
  "providers": [
    {
      "country_code": "NL",
      "country_name": "Netherlands",
      "id": 1376,
      "name": "Cloud86",
      "partner": null,
      "website": "https://cloud86.io"
    },
    {
      "country_code": "NL",
      "country_name": "Netherlands",
      "id": 1449,
      "name": "Leafcloud",
      "partner": null,
      "website": "https://leaf.cloud/"
    }
  ],
  "summary": "Netherlands: 2 green hosting providers listed, matching 'cloud'."
}
```
