{"contractVersion":"parcelops.connector.v1","name":"epa-echo","displayName":"EPA Regulated Facilities","description":"EPA facility, permit, compliance, inspection, and enforcement context across the US.","tags":["environment","facilities","compliance","permits","enforcement","united-states"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"EPA Enforcement and Compliance History Online","sourceUrl":"https://echodata.epa.gov/echo","apiBaseUrl":"https://echodata.epa.gov/echo","documentationUrl":"https://echo.epa.gov/tools/web-services"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Each EPA program publishes its refresh version with query results."}},"coverage":{"geographic":{"status":"declared","value":["United States"]},"temporal":{"status":"not_declared"}},"methods":{"total":6,"items":[{"name":"searchFacilities","description":"Search all-media EPA facilities and return a short-lived results token.","notes":"Proximity: latitude + longitude + radiusMiles together (miles, under 100).","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"county":{"type":"string","maxLength":120},"countyFips":{"type":"string","pattern":"^\\d{1,5}$"},"naics":{"type":"string","pattern":"^\\d{2,6}$"},"sic":{"type":"string","pattern":"^\\d{2,4}$"},"bbox":{"type":"object","properties":{"c1lat":{"type":"number","minimum":-90,"maximum":90},"c1lon":{"type":"number","minimum":-180,"maximum":180},"c2lat":{"type":"number","minimum":-90,"maximum":90},"c2lon":{"type":"number","minimum":-180,"maximum":180}},"required":["c1lat","c1lon","c2lat","c2lon"],"additionalProperties":false},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusMiles":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":100,"description":"Search radius in MILES around latitude/longitude. Required with latitude and longitude; ECHO rejects 0 or 100+."},"activeOnly":{"type":"boolean"}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Each EPA program publishes its refresh version with query results."},"scope":"connector"},"entities":{"status":"declared","value":["facility-search"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"source":{"type":"string"},"resultsToken":{"type":"string","minLength":1},"summary":{"type":"object","additionalProperties":true}},"required":["source","summary"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["A proximity result is a screening lead, not proof of contamination, liability, or regulatory status for a parcel."]},{"name":"searchAirFacilities","description":"Search Clean Air Act facilities and return a short-lived results token.","notes":"countyFips only (county name rejected); proximity = lat+lon+radiusMiles.","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"countyFips":{"type":"string","pattern":"^\\d{1,5}$"},"naics":{"type":"string","pattern":"^\\d{2,6}$"},"sic":{"type":"string","pattern":"^\\d{2,4}$"},"bbox":{"type":"object","properties":{"c1lat":{"type":"number","minimum":-90,"maximum":90},"c1lon":{"type":"number","minimum":-180,"maximum":180},"c2lat":{"type":"number","minimum":-90,"maximum":90},"c2lon":{"type":"number","minimum":-180,"maximum":180}},"required":["c1lat","c1lon","c2lat","c2lon"],"additionalProperties":false},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusMiles":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":100,"description":"Search radius in MILES around latitude/longitude. Required with latitude and longitude; ECHO rejects 0 or 100+."},"activeOnly":{"type":"boolean"}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Each EPA program publishes its refresh version with query results."},"scope":"connector"},"entities":{"status":"declared","value":["facility-search"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"source":{"type":"string"},"resultsToken":{"type":"string","minLength":1},"summary":{"type":"object","additionalProperties":true}},"required":["source","summary"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["A proximity result is a screening lead, not proof of contamination, liability, or regulatory status for a parcel."]},{"name":"searchWaterFacilities","description":"Search Clean Water Act facilities and return a short-lived results token.","notes":"Proximity: latitude + longitude + radiusMiles together (miles, under 100).","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"county":{"type":"string","maxLength":120},"countyFips":{"type":"string","pattern":"^\\d{1,5}$"},"naics":{"type":"string","pattern":"^\\d{2,6}$"},"sic":{"type":"string","pattern":"^\\d{2,4}$"},"bbox":{"type":"object","properties":{"c1lat":{"type":"number","minimum":-90,"maximum":90},"c1lon":{"type":"number","minimum":-180,"maximum":180},"c2lat":{"type":"number","minimum":-90,"maximum":90},"c2lon":{"type":"number","minimum":-180,"maximum":180}},"required":["c1lat","c1lon","c2lat","c2lon"],"additionalProperties":false},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusMiles":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":100,"description":"Search radius in MILES around latitude/longitude. Required with latitude and longitude; ECHO rejects 0 or 100+."},"activeOnly":{"type":"boolean"}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Each EPA program publishes its refresh version with query results."},"scope":"connector"},"entities":{"status":"declared","value":["facility-search"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"source":{"type":"string"},"resultsToken":{"type":"string","minLength":1},"summary":{"type":"object","additionalProperties":true}},"required":["source","summary"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["A proximity result is a screening lead, not proof of contamination, liability, or regulatory status for a parcel."]},{"name":"getFacilityRows","description":"Read curated EPA facility rows for a search results token.","notes":"Pass the preceding search's resultsToken verbatim; it names its own service.","requiredParams":["resultsToken"],"inputSchema":{"type":"object","properties":{"resultsToken":{"type":"string","minLength":1,"maxLength":512},"pageno":{"type":"integer","minimum":1,"maximum":10000},"limit":{"type":"integer","minimum":1,"maximum":250}},"required":["resultsToken"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Each EPA program publishes its refresh version with query results."},"scope":"connector"},"entities":{"status":"declared","value":["regulated-facility"]},"pagination":{"status":"declared","value":{"style":"page","pageField":"pageno","limitField":"limit"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"source":{"type":"string"},"service":{"type":"string"},"resultsToken":{"type":"string","minLength":1},"page":{"type":"integer","minimum":1},"totalRows":{"type":["integer","null"],"minimum":0},"returned":{"type":"integer","minimum":0},"facilities":{"type":"array","items":{"type":"object","additionalProperties":true}},"truncatedTo":{"type":"integer","minimum":1},"note":{"type":"string"}},"required":["source","service","resultsToken","page","totalRows","returned","facilities"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["A proximity result is a screening lead, not proof of contamination, liability, or regulatory status for a parcel."]},{"name":"getDetailedFacilityReport","description":"Get a curated EPA detailed facility report by Registry ID.","notes":"Compliance, enforcement, permits, releases; `note` names the excluded sections.","requiredParams":["registryId"],"inputSchema":{"type":"object","properties":{"registryId":{"type":"string","minLength":1,"maxLength":80}},"required":["registryId"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Each EPA program publishes its refresh version with query results."},"scope":"connector"},"entities":{"status":"declared","value":["regulated-facility-report"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"source":{"type":"string"},"registryId":{"type":"string"},"fullReportUrl":{"type":"string"},"facility":{"type":"object","additionalProperties":true},"dataExtractDates":{"type":"object","additionalProperties":true},"complianceByStatute":{"type":"array","items":{"type":"object","additionalProperties":true}},"caveats":{"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"required":["source","registryId","fullReportUrl","facility","dataExtractDates","complianceByStatute","caveats","note"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["A proximity result is a screening lead, not proof of contamination, liability, or regulatory status for a parcel."]},{"name":"getServiceInfo","description":"Return EPA program coverage, workflow, and freshness notes.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Each EPA program publishes its refresh version with query results."},"scope":"connector"},"entities":{"status":"declared","value":["service-metadata"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"service":{"type":"string"},"baseUrl":{"type":"string"},"auth":{"const":"none"},"coverage":{"type":"string"},"methods":{"type":"object","additionalProperties":{"type":"string"}},"notes":{"type":"array","items":{"type":"string"}}},"required":["service","baseUrl","auth","coverage","methods","notes"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["A proximity result is a screening lead, not proof of contamination, liability, or regulatory status for a parcel."]}]},"caveats":["A proximity result is a screening lead, not proof of contamination, liability, or regulatory status for a parcel."]}