> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Environmental Sites
> Find federally regulated facilities, toxic release reporters and Superfund sites by point, ZIP code or county.
Returns environmental sites and compliance records from the US Environmental Protection Agency near a point or in a ZIP code or county. Includes facility counts, violations, five-year penalties and up to 25 facilities ordered by noncompliance, Superfund status or toxic releases and transfers. Brownfields are not covered.
## Authentication
Requires x402 payment in the `payment-signature` header.
## Request Body
**latitude** `number`
Point latitude in decimal degrees; give longitude too. From -90 to 90.
**longitude** `number`
Point longitude in decimal degrees, west negative; give latitude too. From -180 to 180.
**radius\_km** `number`
Point search radius in kilometres, default 2; only with latitude and longitude. From 0.2 to 16.
**zip\_code** `string`
Five-digit facility ZIP code; placeholder ZIP codes 00000 and 99999 are refused.
**county\_fips** `string`
Five-digit state plus county code, the county\_id returned by Place Resolve (place\_resolve), for example 51059.
**order** `string`
Most quarters in noncompliance, Superfund sites, or largest combined on-site toxic releases and off-site transfers first. One of `noncompliance`, `superfund`, `toxic_releases`. Defaults to `"noncompliance"`.
**limit** `integer`
How many facilities to return. From 1 to 25. Defaults to `10`.
## Response (200 OK)
Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.
**data.request\_id** `string`
Durable job ID for audit and lookup
**data.status** `string`
Job status: `completed`
**data.tool** `string`
Always `place_environmental_sites`
**data.result** `object`
The answer, described under Result below
**data.evidence** `object`
Where the answer came from and when
**data.evidence.source** `string`
The public body the data comes from. Always `US Environmental Protection Agency`.
**data.evidence.source\_kind** `string`
`public` when the data comes from a public body, `commercial` otherwise
**data.evidence.retrieved\_at** `string`
When the lookup was made, as an ISO 8601 UTC time
**data.evidence.as\_of** `string | null`
When the source says the fact was last updated, or `null` when the source gives no date
## Result
Nested under `data.result`.
**data.result.total\_facilities** `number`
Every facility the search matched, including any beyond limit.
**data.result.by\_program** `object`
Matched facility counts by program; a facility can be in several programs.
**data.result.by\_program.air** `number`
Air.
**data.result.by\_program.water\_dischargers** `number`
Water dischargers.
**data.result.by\_program.hazardous\_waste** `number`
Hazardous waste.
**data.result.by\_program.toxic\_releases** `number`
Toxic releases.
**data.result.significant\_violators** `number`
Matched facilities currently designated significant violators.
**data.result.in\_violation\_now** `number`
Matched facilities currently in violation.
**data.result.with\_violations\_3yr** `number`
Matched facilities with violations in the last three years.
**data.result.with\_formal\_actions\_5yr** `number`
Matched facilities with formal enforcement actions in the last five years.
**data.result.inspected\_5yr** `number`
Matched facilities inspected in the last five years.
**data.result.total\_penalties\_usd** `number | null`
Penalties from formal enforcement actions in the last five years, in US dollars, summed over every matched facility. `null` when the source gives no value.
**data.result.facilities** `object[]`
Matching facilities in the requested order, at most limit.
**data.result.facilities\[].name** `string | null`
The facility name as the source records it. `null` when the source gives no value.
**data.result.facilities\[].street** `string | null`
Street address. `null` when the source gives no value.
**data.result.facilities\[].city** `string | null`
City. `null` when the source gives no value.
**data.result.facilities\[].state** `string | null`
Two-letter state code. `null` when the source gives no value.
**data.result.facilities\[].zip** `string | null`
ZIP code. `null` when the source gives no value.
**data.result.facilities\[].county** `string | null`
County name as recorded; may differ from the county searched. `null` when the source gives no value.
**data.result.facilities\[].registry\_id** `string | null`
The identifier the source gives the facility across every program. `null` when the source gives no value.
**data.result.facilities\[].latitude** `number | null`
Facility latitude in decimal degrees. `null` when the source gives no value.
**data.result.facilities\[].longitude** `number | null`
Facility longitude in decimal degrees. `null` when the source gives no value.
**data.result.facilities\[].distance\_km** `number | null`
Great-circle distance from the input point in kilometres, rounded to two decimals; null for ZIP or county searches or missing coordinates.
**data.result.facilities\[].active** `boolean`
True when the source marks the facility active or operating.
**data.result.facilities\[].programs** `string[]`
Programs whose source flag is Y, in air, water discharger, hazardous waste, drinking water, toxic releases, greenhouse gas and Superfund order.
**data.result.facilities\[].superfund\_site\_ids** `string[]`
Superfund site identifiers recorded for this facility.
**data.result.facilities\[].compliance\_status** `string | null`
The overall compliance status the source records, for example Significant Violation, Violation Identified or No Violation Identified. `null` when the source gives no value.
**data.result.facilities\[].significant\_violator** `boolean | null`
True when the source currently designates the facility a high priority violator under the Clean Air Act, in significant noncompliance under the Clean Water Act or the hazardous waste program, or a serious violator under the Safe Drinking Water Act. `null` when the source gives no value.
**data.result.facilities\[].quarters\_in\_violation** `integer | null`
How many of the last twelve quarters the facility had a violation identified, was in noncompliance, or was a significant or high priority violator. `null` when the source gives no value.
**data.result.facilities\[].formal\_actions** `integer | null`
Formal enforcement actions taken against the facility in the last five years. `null` when the source gives no value.
**data.result.facilities\[].penalties\_usd** `number | null`
Penalties assessed against the facility in the last five years, in US dollars. `null` when the source gives no value.
**data.result.facilities\[].last\_inspected\_on** `string | null`
When the most recent compliance monitoring activity took place, YYYY-MM-DD. `null` when the source gives no value.
**data.result.facilities\[].toxic\_releases\_and\_transfers\_lb** `number | null`
Combined on-site chemical releases and off-site transfers, in pounds, reported to the Toxics Release Inventory by the facility for the most recent reporting year; not a measure of on-site releases alone. `null` when the source gives no value.
```bash cURL theme={null}
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-environmental-sites \
-H "Content-Type: application/json" \
-H "payment-signature: " \
-d '{
"latitude": 43.08,
"longitude": -78.95,
"radius_km": 3,
"limit": 3
}'
```
```javascript JavaScript theme={null}
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-environmental-sites", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 43.08,
"longitude": -78.95,
"radius_km": 3,
"limit": 3
}),
});
```
```typescript SDK theme={null}
const result = await agent.tool('lookup/place-environmental-sites', {
latitude: 43.08,
longitude: -78.95,
radius_km: 3,
limit: 3
});
console.log(result.result);
console.log(result.evidence);
```
```json Response (200) theme={null}
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_environmental_sites",
"result": {
"total_facilities": 112,
"by_program": {
"air": 8,
"water_dischargers": 14,
"hazardous_waste": 103,
"toxic_releases": 2
},
"significant_violators": 0,
"in_violation_now": 1,
"with_violations_3yr": 8,
"with_formal_actions_5yr": 0,
"inspected_5yr": 13,
"total_penalties_usd": 0,
"facilities": [
{
"name": "NIAGARA COUNTY SEWER DISTRICT #1 WWTP",
"street": "7346 LIBERTY DRIVE",
"city": "NIAGARA FALLS",
"state": "NY",
"zip": "14304",
"county": "NIAGARA",
"registry_id": "110000735045",
"latitude": 43.070086,
"longitude": -78.922768,
"distance_km": 2.47,
"active": true,
"programs": [
"air",
"water_discharger",
"hazardous_waste"
],
"superfund_site_ids": [],
"compliance_status": "Violation Identified",
"significant_violator": false,
"quarters_in_violation": 12,
"formal_actions": 0,
"penalties_usd": 0,
"last_inspected_on": "2025-08-26",
"toxic_releases_and_transfers_lb": null
},
{
"name": "GRAND ISLAND WASTEWATER TREATMENT PLANT",
"street": "3500 BASELINE RD",
"city": "GRAND ISLAND",
"state": "NY",
"zip": "14072",
"county": "ERIE",
"registry_id": "110000552081",
"latitude": 43.05739,
"longitude": -78.96687,
"distance_km": 2.86,
"active": true,
"programs": [
"water_discharger",
"hazardous_waste"
],
"superfund_site_ids": [],
"compliance_status": "No Violation Identified",
"significant_violator": false,
"quarters_in_violation": 7,
"formal_actions": 0,
"penalties_usd": 0,
"last_inspected_on": "2025-06-26",
"toxic_releases_and_transfers_lb": null
},
{
"name": "ENERPLATE LLC",
"street": "2250 LIBERT DR",
"city": "WHEATFIELD",
"state": "NY",
"zip": "14304",
"county": "NIAGARA",
"registry_id": "110071307855",
"latitude": 43.073,
"longitude": -78.924,
"distance_km": 2.25,
"active": true,
"programs": [
"water_discharger",
"hazardous_waste"
],
"superfund_site_ids": [],
"compliance_status": "No Violation Identified",
"significant_violator": false,
"quarters_in_violation": 5,
"formal_actions": 0,
"penalties_usd": 0,
"last_inspected_on": "2023-08-02",
"toxic_releases_and_transfers_lb": null
}
]
},
"evidence": {
"source": "US Environmental Protection Agency",
"source_kind": "public",
"retrieved_at": "2026-10-26T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-26T12:00:00.000Z"
}
],
"as_of": null
}
}
}
```
> [!NOTE]
>
> See [Pricing](https://docs.oneshotagent.com/pricing.md) for this tool's price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers `200`.
## Notes
* Each program count is a count of facilities; a facility can be in several programs. Superfund sites are listed but not counted in `by_program`: the source gives no Superfund total.
* Use `order: superfund` to bring Superfund sites first, or `order: toxic_releases` for the largest combined on-site releases and off-site transfers. Brownfields are not covered.
* A county search matches recorded county or coordinates, so a few facilities may be recorded under another county name.
* An area too large for one search is refused: use a point with a smaller radius or a ZIP code.
* Counts and total penalties cover every matched facility, including those beyond `limit`. Programs refresh weekly; current state and five-year enforcement counts are provided, with no source history.
* Results return inline. The finished job stays available at `/v1/requests/{request_id}`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.