# EPA Envirofacts

> Look up the US Environmental Protection Agency's public records: facilities and the EPA programs that track them, toxic chemical releases, greenhouse gas emissions, drinking water systems and their violations, hazardous waste handlers, Superfund sites and the daily UV Index forecast. No account or API key required.

App · 13 actions. Web page: https://docs.lodol.com/docs/integrations/epa-envirofacts

## Actions

### Get a drinking water system

Get one public drinking water system: who runs it and how to reach them, the people and places it serves, where its water comes from, and how many violations it has on record, how many put health at risk and how many are unresolved.

**Inputs**

- Water system ID (`pwsid`, text, required): The 9-character public water system ID, two letters and seven digits for most systems. 'Search drinking water systems' finds it.

**Outputs**

- `address` (text): The system's mailing street address.
- `address_city` (text): The city of its mailing address.
- `address_state` (text): The state of its mailing address.
- `address_zip_code` (text): The ZIP code of its mailing address.
- `administrator` (text): The system's administrative contact.
- `cities_served` (text): The cities it serves, when recorded.
- `counties_served` (text): The counties it serves, when recorded.
- `email` (text): The system's email address, when published.
- `epa_region` (text): The EPA region (01 to 10) the system is in.
- `health_based_violation_count` (number): Of those, the ones that put health at risk.
- `name` (text): The water system's name.
- `operator` (text): The organization that runs the system.
- `owner_type` (text): Who owns it, such as Local government or Private.
- `phone` (text): The system's phone number.
- `population_served` (number): How many people it serves.
- `primary_source` (text): Where its water comes from, such as Surface water.
- `pwsid` (text): The system's 9-character public water system ID; the other drinking water actions read it.
- `regulator` (text): Who regulates it: a state code, or an EPA region number for tribal systems.
- `serves_school_or_daycare` (true/false): True when it serves a school or daycare.
- `service_connections` (number): How many service connections it has.
- `status` (text): Active, Inactive, or what became of it.
- `summary` (text): One plain sentence saying what was found.
- `system_type` (text): Community, non-transient or transient non-community.
- `system_type_code` (text): The type's code: CWS, NTNCWS or TNCWS.
- `unresolved_violation_count` (number): Of those, the ones not yet returned to compliance.
- `violation_count` (number): Violations on record, of every kind and status.
- `wholesaler` (true/false): True when it sells water to other systems.

**Example output**

```json
{
  "address": "DIVISION DIRECTOR WATER RESOURCES, 235 PENNY LN",
  "address_city": "BURLINGTON",
  "address_state": "VT",
  "address_zip_code": "05401",
  "administrator": null,
  "cities_served": "BURLINGTON",
  "counties_served": "Chittenden",
  "email": null,
  "epa_region": "01",
  "health_based_violation_count": 0,
  "name": "BURLINGTON DEPT PUBLIC WORKS WATER DIV",
  "operator": null,
  "owner_type": "Local government",
  "phone": "802-863-4501",
  "population_served": 42000,
  "primary_source": "Surface water",
  "pwsid": "VT0005053",
  "regulator": "VT",
  "serves_school_or_daycare": false,
  "service_connections": 9900,
  "status": "Active",
  "summary": "BURLINGTON DEPT PUBLIC WORKS WATER DIV: Community water system serving 42,000 people, 4 violations on record, 1 unresolved.",
  "system_type": "Community water system",
  "system_type_code": "CWS",
  "unresolved_violation_count": 1,
  "violation_count": 4,
  "wholesaler": true
}
```

### Get a Superfund site

Get one Superfund site: where it is, its National Priorities List status, and the contaminants its cleanup decisions name, with where each was found (groundwater, soil, sediment, surface water, air).

**Inputs**

- Site ID (`site_id`, text, required): The site's 12-character EPA ID, or its 7-digit Superfund site ID. 'Search Superfund sites' returns both.

**Outputs**

- `address` (text): Street address or description of where it is.
- `address_line_2` (text): More of the address.
- `archived` (true/false): True when EPA has archived the site: no further action.
- `archived_on` (text): When it was archived (YYYY-MM-DD).
- `city` (text): City.
- `contaminant_names` (list): Every contaminant named, once each, A to Z.
- `contaminants` (list): Each contaminant the site's cleanup decisions name, by medium.
- `county` (text): County.
- `epa_id` (text): The site's 12-character EPA ID, such as VTD980523062.
- `epa_region` (text): The EPA region (01 to 10) the site is in.
- `federal_facility` (true/false): True when a federal agency is responsible.
- `latitude` (number): Latitude in decimal degrees.
- `longitude` (number): Longitude in decimal degrees (negative west of Greenwich).
- `media` (list): Where contaminants were found, such as Groundwater.
- `name` (text): The site's name.
- `npl_status` (text): Where it stands on the National Priorities List, the list of the country's most serious sites.
- `npl_status_code` (text): The status's one-letter code.
- `other_status` (text): Its latest status for a site not on the list.
- `other_status_date` (text): When that status was set (YYYY-MM-DD).
- `site_id` (text): The site's 7-digit Superfund site ID.
- `site_url` (text): Link to the site's profile on EPA's website.
- `state` (text): Two-letter state code.
- `summary` (text): One plain sentence saying what was found.
- `zip_code` (text): ZIP code.

**Example output**

```json
{
  "address": "PINE STREET",
  "address_line_2": null,
  "archived": false,
  "archived_on": null,
  "city": "BURLINGTON",
  "contaminant_names": [
    "1,2-DICHLOROETHANE",
    "1,2-DICHLOROETHENE (CIS AND TRANS MIXTURE)",
    "1,2-DIHYDROACENAPHTHYLENE"
  ],
  "contaminants": [
    {
      "contaminant": "1,2-DICHLOROETHANE",
      "decision_document": "Record of Decision",
      "medium": "Groundwater",
      "operable_unit": "01"
    },
    {
      "contaminant": "1,2-DIHYDROACENAPHTHYLENE",
      "decision_document": "Record of Decision",
      "medium": "Groundwater",
      "operable_unit": "01"
    },
    {
      "contaminant": "2-HEXANONE",
      "decision_document": "Record of Decision",
      "medium": "Groundwater",
      "operable_unit": "01"
    }
  ],
  "county": "CHITTENDEN",
  "epa_id": "VTD980523062",
  "epa_region": "01",
  "federal_facility": false,
  "latitude": 44.466669,
  "longitude": -73.218061,
  "media": [
    "Groundwater",
    "Sediment",
    "Soil",
    "Surface Water"
  ],
  "name": "PINE STREET CANAL",
  "npl_status": "Currently on the Final NPL",
  "npl_status_code": "F",
  "other_status": null,
  "other_status_date": null,
  "site_id": "0101479",
  "site_url": "https://cumulis.epa.gov/supercpad/cursites/csitinfo.cfm?id=0101479",
  "state": "VT",
  "summary": "PINE STREET CANAL, BURLINGTON, VT: Currently on the Final NPL; 52 contaminants named in groundwater, sediment, soil, surface water.",
  "zip_code": "05401"
}
```

### Get an EPA facility

Get one facility from EPA's registry by its registry ID: its address and coordinates, its industry codes, and every EPA program that tracks it (toxic releases, greenhouse gases, hazardous waste, air and water permits, drinking water and more) with its ID in each, ready for the other steps.

**Inputs**

- Registry ID (`registry_id`, text, required): The facility's 12-digit EPA registry ID. 'Search EPA facilities' finds it.

**Outputs**

- `address` (text): Street address.
- `address_line_2` (text): More of the address, when EPA has it.
- `city` (text): City.
- `county` (text): County.
- `county_fips` (text): The county's five-digit FIPS code.
- `drinking_water_system_id` (text): The facility's public water system ID, if it runs one.
- `epa_region` (text): The EPA region (01 to 10) the facility is in.
- `federal_facility` (true/false): True when a federal agency runs the facility.
- `greenhouse_gas_facility_id` (text): The facility's Greenhouse Gas Reporting Program ID, if it reports there.
- `hazardous_waste_handler_id` (text): The facility's hazardous waste (RCRAInfo) handler ID, if it has one.
- `industries` (list): The facility's industry codes.
- `latitude` (number): Latitude in decimal degrees.
- `longitude` (number): Longitude in decimal degrees (negative west of Greenwich).
- `name` (text): The facility's name, as EPA records it.
- `programs` (list): Every EPA program record linked to the facility.
- `registry_id` (text): The facility's 12-digit EPA registry ID, which every EPA program shares.
- `report_url` (text): Link to the facility's compliance report on EPA's ECHO website.
- `site_type` (text): The kind of site, such as STATIONARY.
- `state` (text): Two-letter state code.
- `summary` (text): One plain sentence saying what was found.
- `toxics_release_inventory_id` (text): The facility's Toxics Release Inventory ID, if it reports there; 'List toxic chemical releases' reads it.
- `tribal_land` (text): The tribal land the facility is on, if any.
- `zip_code` (text): ZIP code.

**Example output**

```json
{
  "address": "1000 RIVER ST",
  "address_line_2": "ESSEX JUNCTION",
  "city": "ESSEX JUNCTION",
  "county": "CHITTENDEN",
  "county_fips": "50007",
  "drinking_water_system_id": null,
  "epa_region": "01",
  "federal_facility": null,
  "greenhouse_gas_facility_id": null,
  "hazardous_waste_handler_id": "VTR000524868",
  "industries": [
    {
      "description": "SEMICONDUCTOR AND RELATED DEVICE MANUFACTURING",
      "naics_code": "334413",
      "primary": true
    }
  ],
  "latitude": 44.484119,
  "longitude": -73.111709,
  "name": "GLOBALFOUNDRIES",
  "programs": [
    {
      "name_in_program": "GLOBALFOUNDRIES US 2 LLC",
      "program": "AIR",
      "program_id": "VT0000005000700012",
      "program_name": "Clean Air Act stationary sources (ICIS-Air)"
    },
    {
      "name_in_program": "GLOBALFOUNDRIES",
      "program": "EIS",
      "program_id": "7726511",
      "program_name": "National Emissions Inventory"
    },
    {
      "name_in_program": "GLOBALFOUNDRIES U S 2 LLC",
      "program": "OSHA-OIS",
      "program_id": "341300812",
      "program_name": "Occupational Safety and Health Administration"
    }
  ],
  "registry_id": "110070828160",
  "report_url": "https://echo.epa.gov/detailed-facility-report?fid=110070828160",
  "site_type": "STATIONARY",
  "state": "VT",
  "summary": "GLOBALFOUNDRIES, ESSEX JUNCTION, VT: tracked by 6 EPA programs.",
  "toxics_release_inventory_id": "05452BMXXX1000R",
  "tribal_land": null,
  "zip_code": "05452"
}
```

### Get greenhouse gas emissions

Get a facility's greenhouse gas emissions as reported to EPA: the total for each year, and each year broken down by gas (carbon dioxide, methane, nitrous oxide and the fluorinated gases) and by source, all in metric tons of CO2 equivalent.

**Inputs**

- Facility ID (`facility_id`, text, required): The facility's Greenhouse Gas Reporting Program ID, a number. 'Search greenhouse gas facilities' finds it.
- From year (`from_year`, number): Only years from this one on. Leave it empty for all. From 2010 to 2100.
- To year (`to_year`, number): Only years up to this one. Leave it empty for all. From 2010 to 2100.

**Outputs**

- `city` (text): The facility's city.
- `emissions` (list): Each year's emissions by gas and source, largest first.
- `facility_id` (number): The facility's Greenhouse Gas Reporting Program ID.
- `facility_name` (text): The facility's name.
- `latest_total_co2e_tonnes` (number): That year's total, in metric tons of CO2 equivalent.
- `latest_year` (number): The most recent year with emissions here.
- `state` (text): The facility's state.
- `summary` (text): One plain sentence saying what was found.
- `years` (list): The total for each year, newest first.

**Example output**

```json
{
  "city": "ESSEX JUNCTION",
  "emissions": [
    {
      "co2e_tonnes": 46366.174,
      "gas": "PFCs",
      "gas_code": "PFC",
      "sector": "Other",
      "subsector": "Electronics Manufacturing",
      "year": 2023
    },
    {
      "co2e_tonnes": 36016.0,
      "gas": "Carbon Dioxide",
      "gas_code": "CO2",
      "sector": "Other",
      "subsector": "Electronics Manufacturing",
      "year": 2023
    },
    {
      "co2e_tonnes": 18254.36,
      "gas": "Nitrogen Triflouride",
      "gas_code": "NF3",
      "sector": "Other",
      "subsector": "Electronics Manufacturing",
      "year": 2023
    }
  ],
  "facility_id": 1003726,
  "facility_name": "GLOBALFOUNDRIES U.S. 2 LLC - Vermont Facility",
  "latest_total_co2e_tonnes": 142164.617,
  "latest_year": 2023,
  "state": "VT",
  "summary": "GLOBALFOUNDRIES U.S. 2 LLC - Vermont Facility reported 142,165 metric tons of CO2e in 2023.",
  "years": [
    {
      "total_co2e_tonnes": 142164.617,
      "year": 2023
    },
    {
      "total_co2e_tonnes": 252976.545,
      "year": 2022
    }
  ]
}
```

### Get the daily UV forecast

Get the day's UV Index forecast for a US ZIP code or city, with its risk level and whether EPA has issued a UV Alert for unusually strong sun. The forecast is published the day before.

**Inputs**

- ZIP code (`zip_code`, text): A five-digit ZIP code. Or leave it empty and give a city.
- City (`city`, text): A city, used with its state when no ZIP code is given.
- State (`state`, text): The city's state, when a city is given. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.

**Outputs**

- `city` (text): The city the forecast is for.
- `date` (text): The day forecast (YYYY-MM-DD).
- `risk_level` (text): Low, Moderate, High, Very High or Extreme.
- `state` (text): The state the forecast is for.
- `summary` (text): One plain sentence saying what was found.
- `uv_alert` (true/false): True when EPA has issued a UV Alert: unusually strong sun for the time of year.
- `uv_index` (number): The forecast UV Index, from 0 up.
- `zip_code` (text): The ZIP code the forecast is for.

**Example output**

```json
{
  "city": "Washington",
  "date": "2026-11-01",
  "risk_level": "Moderate",
  "state": "DC",
  "summary": "UV Index for 20460 on 2026-11-01: 3 (Moderate).",
  "uv_alert": false,
  "uv_index": 3,
  "zip_code": "20460"
}
```

### List drinking water violations

List a drinking water system's Safe Drinking Water Act violations, newest first: what went wrong, the contaminant, whether it put health at risk, and whether the system has returned to compliance. Narrow by date, category, status or to health-based violations only.

**Inputs**

- Water system ID (`pwsid`, text, required): The 9-character public water system ID, two letters and seven digits for most systems. 'Search drinking water systems' finds it.
- Began on or after (`began_after`, date): Only violations whose period began on or after this day.
- Began on or before (`began_before`, date): Only violations whose period began on or before this day.
- Health-based only (`health_based_only`, true/false): Only violations that put health at risk: a contaminant over its limit or a treatment failure, not a missed test or a late report. Default: `false`.
- Category (`category`, text): Only violations of one kind. One of: `MCL` (Contaminant over its limit), `MRDL` (Disinfectant over its limit), `TT` (Treatment technique), `MR` (Monitoring and reporting), `MON` (Monitoring (coliform rule)), `RPT` (Reporting (coliform rule)), `Other`.
- Status (`status`, text): Only unresolved violations, or only those the system has returned to compliance from. Leave it empty for all. One of: `unresolved`, `resolved` (Returned to compliance), `any`.
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many records this page holds.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `pwsid` (text): The water system's ID.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.
- `violations` (list): The matching violations, newest first.
- `water_system_name` (text): The water system's name.

**Example output**

```json
{
  "count": 2,
  "has_more": true,
  "page": 1,
  "pwsid": "VT0005053",
  "summary": "4 violations match; showing 1 to 2.",
  "total": 4,
  "violations": [
    {
      "allowed_level": null,
      "began_on": "2026-05-01",
      "category": "Monitoring Violation",
      "contaminant": "REVISED TOTAL COLIFORM RULE",
      "contaminant_code": "8000",
      "ended_on": "2026-05-31",
      "health_based": false,
      "measured_level": null,
      "public_notice_tier": 3,
      "returned_to_compliance_on": null,
      "status": "Known",
      "unit": null,
      "violation": "Monitoring Violation (code 3A)",
      "violation_code": "3A",
      "violation_id": "331"
    },
    {
      "allowed_level": null,
      "began_on": "2025-07-02",
      "category": "Reporting Violation",
      "contaminant": "Contaminant code 5200",
      "contaminant_code": "5200",
      "ended_on": null,
      "health_based": false,
      "measured_level": null,
      "public_notice_tier": 3,
      "returned_to_compliance_on": "2025-11-25",
      "status": "Returned to Compliance",
      "unit": null,
      "violation": "Reporting Violation (code 4H)",
      "violation_code": "4H",
      "violation_id": "332"
    }
  ],
  "water_system_name": "BURLINGTON DEPT PUBLIC WORKS WATER DIV"
}
```

### List toxic chemical releases

List the toxic chemicals a facility reported to EPA's Toxics Release Inventory, newest year first: how much of each went into the air, water and land at the site, how much was sent away for disposal, and whether it is a carcinogen or a PFAS. Narrow to one year or one chemical.

**Inputs**

- TRI facility ID (`tri_facility_id`, text, required): The facility's 15-character Toxics Release Inventory ID. 'Search Toxics Release Inventory facilities' and 'Get an EPA facility' both return it.
- Reporting year (`reporting_year`, number): Only reports for this year. Leave it empty for every year since 1987. A year's reports are published the following autumn. From 1987 to 2100.
- Chemical (`chemical`, text): Only this chemical. Pick it from the list, or type a CAS number or part of its name.
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `city` (text): The facility's city.
- `count` (number): How many records this page holds.
- `facility_name` (text): The facility's name.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `pounds_released` (number): The releases on this page that are in pounds, added together.
- `releases` (list): One row per chemical per year, newest year first.
- `state` (text): The facility's state.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.
- `tri_facility_id` (text): The facility's Toxics Release Inventory ID.

**Example output**

```json
{
  "city": "ESSEX JUNCTION",
  "count": 2,
  "facility_name": "GLOBALFOUNDRIES U.S. 2 LLC - VERMONT FACILITY",
  "has_more": true,
  "page": 1,
  "pounds_released": 20947.0,
  "releases": [
    {
      "air": 16317.0,
      "carcinogen": false,
      "cas_number": "7664-41-7",
      "chemical": "Ammonia",
      "chemical_id": "0007664417",
      "document_number": "1323222342610",
      "form_type": "Form R",
      "land": 0.0,
      "off_site": 1295.0,
      "on_site": 18850.0,
      "pfas": false,
      "reporting_year": 2023,
      "total_released": 20145.0,
      "unit": "Pounds",
      "waste_managed": 70875.7,
      "water": 2533.0
    },
    {
      "air": 53.0,
      "carcinogen": false,
      "cas_number": "107-21-1",
      "chemical": "Ethylene glycol",
      "chemical_id": "0000107211",
      "document_number": "1323222294771",
      "form_type": "Form R",
      "land": 0.0,
      "off_site": 261.0,
      "on_site": 541.0,
      "pfas": false,
      "reporting_year": 2023,
      "total_released": 802.0,
      "unit": "Pounds",
      "waste_managed": 8762.2,
      "water": 488.0
    }
  ],
  "state": "VT",
  "summary": "10 chemical reports match; showing 1 to 2.",
  "total": 10,
  "tri_facility_id": "05452BMXXX1000R"
}
```

### Search drinking water systems

Search the public drinking water systems EPA regulates, largest first: by name, state, the city or county they serve, or ZIP code, and by type and water source. Each comes back with its water system ID, the people it serves and who owns it.

**Inputs**

- Name (`name`, text): Only systems whose name contains this.
- State (`state`, text): Only systems this state regulates. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- City served (`city_served`, text): Only systems that serve this city, by its whole name. Pair it with a state.
- County served (`county_served`, text): Only systems that serve this county, with or without the word "County". Pair it with a state.
- ZIP code (`zip_code`, text): Only systems whose mailing address is in this ZIP code. The first three digits find a whole area.
- System type (`system_type`, text): Only one kind of system. Community systems serve people where they live; the other two serve places such as schools and offices, or campsites and gas stations. One of: `CWS` (Community water system), `NTNCWS` (Non-transient non-community (schools, offices)), `TNCWS` (Transient non-community (campsites, rest stops)).
- Water source (`water_source`, text): Only systems drawing mainly on ground or surface water. One of: `ground` (Ground water), `surface` (Surface water).
- Status (`status`, text): Active systems unless you choose otherwise. One of: `active`, `inactive` (Inactive or merged), `any`. Default: `active`.
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many records this page holds.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.
- `water_systems` (list): The matching water systems, largest first.

**Example output**

```json
{
  "count": 2,
  "has_more": false,
  "page": 1,
  "summary": "2 water systems match.",
  "total": 2,
  "water_systems": [
    {
      "address_city": "BURLINGTON",
      "address_state": "VT",
      "address_zip_code": "05401",
      "cities_served": "BURLINGTON",
      "counties_served": "Chittenden",
      "name": "BURLINGTON DEPT PUBLIC WORKS WATER DIV",
      "owner_type": "Local government",
      "population_served": 42000,
      "primary_source": "Surface water",
      "pwsid": "VT0005053",
      "regulator": "VT",
      "service_connections": 9900,
      "status": "Active",
      "system_type": "Community water system",
      "system_type_code": "CWS"
    },
    {
      "address_city": "WOONSOCKET",
      "address_state": "RI",
      "address_zip_code": "02895",
      "cities_served": "BURLINGTON",
      "counties_served": "Chittenden",
      "name": "NORTH AVE CO-OP",
      "owner_type": "Private",
      "population_served": 301,
      "primary_source": "Surface water purchased",
      "pwsid": "VT0021071",
      "regulator": "VT",
      "service_connections": 115,
      "status": "Active",
      "system_type": "Community water system",
      "system_type_code": "CWS"
    }
  ]
}
```

### Search EPA facilities

Search EPA's master list of facilities (the Facility Registry Service): factories, power plants, landfills, gas stations, farms and every other site an EPA program tracks. Narrow by name, state, city, county, ZIP code or industry. Each facility comes back with its registry ID, address, coordinates and a link to its compliance report, and the result says how many match in all.

**Inputs**

- Name (`name`, text): Only facilities whose name contains this.
- State (`state`, text): Only facilities in this state. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- City (`city`, text): Only records in this city. The whole name, in any capitals; pair it with a state, since many cities share a name.
- County (`county`, text): Only records in this county, with or without the word "County". Pair it with a state.
- ZIP code (`zip_code`, text): Only records in this ZIP code. The first three digits find a whole area.
- Industry code (`industry_code`, text): Only facilities in this industry, by its NAICS code. A shorter code takes in every industry under it: 3344 is all semiconductor and electronic component makers.
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many records this page holds.
- `facilities` (list): The matching facilities.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.

**Example output**

```json
{
  "count": 2,
  "facilities": [
    {
      "address": "1000 RIVER ST",
      "address_line_2": "ESSEX JUNCTION",
      "city": "ESSEX JUNCTION",
      "county": "CHITTENDEN",
      "epa_region": "01",
      "latitude": 44.484119,
      "longitude": -73.111709,
      "name": "GLOBALFOUNDRIES",
      "registry_id": "110070828160",
      "report_url": "https://echo.epa.gov/detailed-facility-report?fid=110070828160",
      "state": "VT",
      "zip_code": "05452"
    },
    {
      "address": "1040 ROBINSON PARKWAY",
      "address_line_2": null,
      "city": "ESSEX JUNCTION",
      "county": "ESSEX",
      "epa_region": null,
      "latitude": 44.47473,
      "longitude": -73.09758,
      "name": "GLOBALFOUNDRIES",
      "registry_id": "110071307957",
      "report_url": "https://echo.epa.gov/detailed-facility-report?fid=110071307957",
      "state": "VT",
      "zip_code": "05452"
    }
  ],
  "has_more": true,
  "page": 1,
  "summary": "4 facilities match; showing 1 to 2.",
  "total": 4
}
```

### Search greenhouse gas facilities

Search the large emitters that report to EPA's Greenhouse Gas Reporting Program (power plants, refineries, landfills, factories and gas suppliers), by name, state, city, county or ZIP code. Each comes back with its total emissions for the year in metric tons of CO2 equivalent.

**Inputs**

- Name (`name`, text): Only facilities whose name contains this.
- State (`state`, text): Only facilities in this state. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- City (`city`, text): Only records in this city. The whole name, in any capitals; pair it with a state, since many cities share a name.
- County (`county`, text): Only records in this county, with or without the word "County". Pair it with a state.
- ZIP code (`zip_code`, text): Only records in this ZIP code. The first three digits find a whole area.
- Reporting year (`reporting_year`, number): The year to report on. Leave it empty for the latest year EPA has published. From 2010 to 2100.
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many records this page holds.
- `facilities` (list): The matching facilities.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `reporting_year` (number): The reporting year searched.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.

**Example output**

```json
{
  "count": 2,
  "facilities": [
    {
      "address": "869 Exchange St",
      "city": "Middlebury",
      "county": "ADDISON COUNTY",
      "facility_id": 1011305,
      "facility_types": null,
      "latitude": 44.03105,
      "longitude": -73.17078,
      "naics_code": "311513",
      "name": "Agri-Mark",
      "parent_companies": "AGRI-MARK INC (100%)",
      "registry_id": "110040608205",
      "reporting_year": 2023,
      "state": "VT",
      "total_co2e_tonnes": null,
      "zip_code": "05753"
    },
    {
      "address": "235 Penny Lane",
      "city": "Burlington",
      "county": "CHITTENDEN COUNTY",
      "facility_id": 1013524,
      "facility_types": null,
      "latitude": 44.4917,
      "longitude": -73.2081,
      "naics_code": "221112",
      "name": "Burlington Electric",
      "parent_companies": null,
      "registry_id": "110070671133",
      "reporting_year": 2023,
      "state": "VT",
      "total_co2e_tonnes": null,
      "zip_code": "05401"
    }
  ],
  "has_more": true,
  "page": 1,
  "reporting_year": 2023,
  "summary": "13 facilities match; showing 1 to 2. Reporting year 2023.",
  "total": 13
}
```

### Search hazardous waste handlers

Search the businesses and sites registered with EPA's hazardous waste program (RCRAInfo), by name, state, city or ZIP code, and by how much waste they generate. Each comes back with its EPA ID, location, generator size and whether it transports, treats, stores, disposes of or recycles hazardous waste.

**Inputs**

- Name (`name`, text): Only handlers whose name contains this.
- State (`state`, text): Only handlers in this state. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- City (`city`, text): Only records in this city. The whole name, in any capitals; pair it with a state, since many cities share a name.
- ZIP code (`zip_code`, text): Only records in this ZIP code. The first three digits find a whole area.
- Generator size (`generator_size`, text): Only handlers generating this much hazardous waste a month: large is 1,000 kg or more, small 100 to 1,000 kg, very small less than 100 kg. One of: `large` (Large quantity generator), `small` (Small quantity generator), `very_small` (Very small quantity generator), `none` (Not a generator).
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many records this page holds.
- `handlers` (list): The matching handlers.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.

**Example output**

```json
{
  "count": 2,
  "handlers": [
    {
      "address": "1040 ROBINSON PARKWAY",
      "address_line_2": null,
      "city": "ESSEX JUNCTION",
      "generator_status": "Not a Generator",
      "handler_id": "VTP000561871",
      "last_notified_on": "2022-12-13",
      "latitude": 44.482517,
      "longitude": -73.106516,
      "name": "GLOBALFOUNDRIES",
      "recycler": false,
      "state": "VT",
      "transporter": false,
      "treats_stores_or_disposes": false,
      "zip_code": "05452"
    },
    {
      "address": "1000 RIVER ROAD - B966",
      "address_line_2": "ESSEX JUNCTION",
      "city": "ESSEX",
      "generator_status": "Large Quantity Generator",
      "handler_id": "VTR000524868",
      "last_notified_on": "2026-06-26",
      "latitude": 44.479102,
      "longitude": -73.058347,
      "name": "GLOBALFOUNDRIES US 2 LLC-VERMONT FACILITY",
      "recycler": false,
      "state": "VT",
      "transporter": false,
      "treats_stores_or_disposes": true,
      "zip_code": "05452"
    }
  ],
  "has_more": false,
  "page": 1,
  "summary": "2 handlers match.",
  "total": 2
}
```

### Search Superfund sites

Search Superfund sites, the contaminated land EPA has assessed or is cleaning up, by name, state, city, county or ZIP code, and by where they stand on the National Priorities List of the country's most serious sites. Each comes back with its EPA ID and a link to its profile.

**Inputs**

- Name (`name`, text): Only sites whose name contains this.
- State (`state`, text): Only sites in this state. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- City (`city`, text): Only records in this city. The whole name, in any capitals; pair it with a state, since many cities share a name.
- County (`county`, text): Only records in this county, with or without the word "County". Pair it with a state.
- ZIP code (`zip_code`, text): Only records in this ZIP code. The first three digits find a whole area.
- National Priorities List status (`npl_status`, text): Only sites with this status. Sites on the final list are the ones under long-term cleanup. One of: `F` (On the final list), `P` (Proposed for the list), `D` (Deleted from the list (cleaned up)), `N` (Not on the list), `A` (Part of a listed site), `S` (Being considered for proposal), `R` (Removed from the proposed list), `W` (Withdrawn from the final list).
- Include archived sites (`include_archived`, true/false): Also list sites EPA has archived, where it decided no further federal action was needed. Off unless you turn it on. Default: `false`.
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many records this page holds.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `sites` (list): The matching sites.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.

**Example output**

```json
{
  "count": 2,
  "has_more": true,
  "page": 1,
  "sites": [
    {
      "address": "OFF HOUGHTON LANE",
      "address_line_2": null,
      "archived": false,
      "archived_on": null,
      "city": "BENNINGTON",
      "county": "BENNINGTON",
      "epa_id": "VTD981064223",
      "epa_region": "01",
      "federal_facility": false,
      "latitude": 42.922219,
      "longitude": -73.197781,
      "name": "BENNINGTON MUNICIPAL SANITARY LANDFILL",
      "npl_status": "Currently on the Final NPL",
      "npl_status_code": "F",
      "other_status": null,
      "other_status_date": null,
      "site_id": "0101493",
      "site_url": "https://cumulis.epa.gov/supercpad/cursites/csitinfo.cfm?id=0101493",
      "state": "VT",
      "zip_code": "05201"
    },
    {
      "address": "RTE 5",
      "address_line_2": null,
      "archived": false,
      "archived_on": null,
      "city": "ROCKINGHAM",
      "county": "WINDHAM",
      "epa_id": "VTD980520092",
      "epa_region": "01",
      "federal_facility": false,
      "latitude": 43.226389,
      "longitude": -72.439719,
      "name": "BFI SANITARY LANDFILL (ROCKINGHAM)",
      "npl_status": "Currently on the Final NPL",
      "npl_status_code": "F",
      "other_status": null,
      "other_status_date": null,
      "site_id": "0101475",
      "site_url": "https://cumulis.epa.gov/supercpad/cursites/csitinfo.cfm?id=0101475",
      "state": "VT",
      "zip_code": "05101"
    }
  ],
  "summary": "12 Superfund sites match; showing 1 to 2.",
  "total": 12
}
```

### Search Toxics Release Inventory facilities

Search the facilities that report their toxic chemical releases to EPA's Toxics Release Inventory, by name, state, city, county or ZIP code. Each comes back with the TRI ID that 'List toxic chemical releases' reads, and its parent company.

**Inputs**

- Name (`name`, text): Only facilities whose name contains this.
- State (`state`, text): Only facilities in this state. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- City (`city`, text): Only records in this city. The whole name, in any capitals; pair it with a state, since many cities share a name.
- County (`county`, text): Only records in this county, with or without the word "County". Pair it with a state.
- ZIP code (`zip_code`, text): Only records in this ZIP code. The first three digits find a whole area.
- Include closed facilities (`include_closed`, true/false): Also list facilities that have closed. Off unless you turn it on. Default: `false`.
- Results per page (`limit`, number): How many records to return at once: 25 unless you say, up to 500. From 1 to 500. Default: `25`.
- Page (`page`, number): Which page of results to return, from 1. The result says when there are more. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many records this page holds.
- `facilities` (list): The matching facilities.
- `has_more` (true/false): True when more matches follow on the next page.
- `page` (number): The page of results this is, from 1.
- `summary` (text): One plain sentence saying what was found.
- `total` (number): How many records match the search in all, across every page.

**Example output**

```json
{
  "count": 2,
  "facilities": [
    {
      "address": "26 THOMPSON DR",
      "city": "ESSEX JUNCTION",
      "closed": false,
      "county": "CHITTENDEN",
      "epa_region": "1",
      "name": "BELDEN CDT INC ESSEX JUNCTION",
      "parent_company": "BELDEN CDT INC",
      "registry_id": "110000314838",
      "state": "VT",
      "tri_facility_id": "05451CPRNDTHOMP",
      "zip_code": "05452"
    },
    {
      "address": "1000 RIVER ST",
      "city": "ESSEX JUNCTION",
      "closed": false,
      "county": "CHITTENDEN",
      "epa_region": "1",
      "name": "GLOBALFOUNDRIES U.S. 2 LLC - VERMONT FACILITY",
      "parent_company": "GLOBALFOUNDRIES US INC",
      "registry_id": "110070828160",
      "state": "VT",
      "tri_facility_id": "05452BMXXX1000R",
      "zip_code": "05452"
    }
  ],
  "has_more": true,
  "page": 1,
  "summary": "3 facilities match; showing 1 to 2.",
  "total": 3
}
```
