{"contractVersion":"parcelops.connector.v1","name":"co-ecmc","displayName":"Colorado ECMC Oil & Gas Proximity","description":"Colorado oil and gas proximity and encumbrance for a parcel, read from the Energy & Carbon Management Commission's own keyless map services: well surface points, approved and reported pad footprint polygons, facilities and pits, and the docketed applications pending on a section. Built to answer whether something sits inside a setback, overlaps a footprint, or is about to be drilled next door. Fracking near a home means these well records. Well and facility status codes decode through the labels ECMC publishes in its own map legend, and distances are metric from the coordinate supplied. Flowlines, inspections, violations, and spills are not reachable through this API; the connector states those gaps instead of implying coverage. Live record counts come from the service-info method.","tags":["colorado","ecmc","cogcc","oil-and-gas","wells","setback","rule-604","land","residential","due-diligence","mineral-estate","weld-county","dj-basin"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"Colorado Energy & Carbon Management Commission (ECMC) public ArcGIS services","sourceUrl":"https://gisdnr.state.co.us/arcgis/rest/services/ECMC_Public","apiBaseUrl":"https://gisdnr.state.co.us/arcgis/rest/services/ECMC_Public","documentationUrl":"https://ecmc.state.co.us/data2.html"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"statusDate","notes":"ECMC's FGDC metadata states a daily update frequency. Probed 2026-08-10, the facilities layer carried status_date values through 2026-08-07 while the permits layer had not moved past 2025-12-10."}},"coverage":{"geographic":{"status":"declared","value":["Colorado (statewide), every county under Colorado Energy & Carbon Management Commission jurisdiction"]},"temporal":{"status":"declared","value":{"notes":"Wells and locations span the full ECMC permitting record including plugged and abandoned wells. The permits layer is a curated slice observed at 2023-01-12 through 2025-12-10 on 2026-08-10."}}},"methods":{"total":6,"items":[{"name":"searchWellsNearPoint","description":"Find ECMC wells near a point, defaulting to Colorado's 2,000 ft Rule 604 setback radius.","notes":"Radius defaults to 610 m, the Rule 604 2,000 ft setback distance.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"WGS84 latitude of the parcel point being screened."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"WGS84 longitude of the parcel point being screened."},"radiusMeters":{"type":"number","exclusiveMinimum":0,"maximum":25000,"description":"Search radius in metres. Defaults to 610 m — the 2,000 ft setback in Colorado Rule 604 (2 CCR 404-1-604), measured there from a Residential or High Occupancy Building Unit to a proposed location. A radius around a supplied point is a screening signal, not a compliance determination."},"status":{"type":"string","enum":["producing","plugged","shutIn","drilling","all"],"description":"Filters on the ECMC well status code. Defaults to all statuses."},"operator":{"type":"string","maxLength":120,"description":"Case-insensitive substring of the operator name as ECMC publishes it."},"apiCountyCode":{"type":"string","pattern":"^\\d{1,3}$","description":"ECMC API county prefix such as 123, the only county key these layers carry. Not a FIPS code."},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":100000},"format":{"type":"string","enum":["records","geojson"],"description":"geojson returns GeoJSON Features in records for map rendering."}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"statusDate","notes":"ECMC's FGDC metadata states a daily update frequency. Probed 2026-08-10, the facilities layer carried status_date values through 2026-08-07 while the permits layer had not moved past 2025-12-10."},"scope":"connector"},"entities":{"status":"declared","value":["well"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"radiusMeters":"meter","distanceMeters":"meter"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["ECMC and Colorado DNR publish this data \"as is\" with no warranty of any kind. Verify any result with ECMC before relying on it for a transaction, a setback determination, or a seller disclosure.","Proximity is a screening signal, not a compliance determination. Rule 604 measures 2,000 ft from a Residential or High Occupancy Building Unit to a proposed location, allows substantially equivalent protections, and adds conditions inside Disproportionately Impacted Communities.","Distances are measured from the coordinate supplied, not from a parcel outline. A parcel centroid is not its footprint.","Inspections, violations (NOAVs), spills, and complaints are NOT reachable through this API. ECMC publishes them only as per-facility HTML on COGIS or as monthly bulk files, so this connector does not cover them.","Flowlines are not covered: the ECMC flow-pipes service advertises query support and returns HTTP 400 on every query, so Colorado flowline proximity cannot be answered here.","Subsurface horizontal laterals are not yet covered. A lateral can run under a parcel whose surface hole is miles away, so a zero-well answer does not mean nothing runs underneath.","Production, casing, cement, completion, and injection-pressure detail are deliberately excluded; those are ECMC COGIS scout-card fields outside this connector's purpose.","No ECMC layer carries a county name or FIPS field. County is encoded only in the API-number prefix under ECMC's own code scheme, so no county name is ever inferred here.","Coordinates are the surface hole location. A horizontal lateral from a distant surface hole can still run under the parcel and is not covered here.","The wells layer publishes no status-date column; statusDate is parsed out of ECMC's rendered map-popup string and is null when unparseable."]},{"name":"searchOilGasLocations","description":"Find approved and reported oil and gas surface footprint polygons over a bbox or point.","notes":"Pass either bbox or latitude and longitude, never both.","inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"WGS84 latitude of the parcel point being screened."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"WGS84 longitude of the parcel point being screened."},"radiusMeters":{"type":"number","exclusiveMinimum":0,"maximum":25000,"description":"Search radius in metres. Defaults to 610 m — the 2,000 ft setback in Colorado Rule 604 (2 CCR 404-1-604), measured there from a Residential or High Occupancy Building Unit to a proposed location. A radius around a supplied point is a screening signal, not a compliance determination."},"bbox":{"type":"array","minItems":4,"maxItems":4,"items":{"type":"number"},"description":"[minLongitude, minLatitude, maxLongitude, maxLatitude] in WGS84 — e.g. a parcel bbox."},"formType":{"type":"string","enum":["approvedLocation","location","all"],"description":"approvedLocation is the Form 2A approved footprint. Defaults to all."},"status":{"type":"string","enum":["active","abandonedLocation","closed","all"],"description":"Location status, not well status. Defaults to all."},"operator":{"type":"string","maxLength":120,"description":"Case-insensitive substring of the operator name as ECMC publishes it."},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":100000},"format":{"type":"string","enum":["records","geojson"],"description":"geojson returns GeoJSON Features in records for map rendering."}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"statusDate","notes":"ECMC's FGDC metadata states a daily update frequency. Probed 2026-08-10, the facilities layer carried status_date values through 2026-08-07 while the permits layer had not moved past 2025-12-10."},"scope":"connector"},"entities":{"status":"declared","value":["oil and gas location footprint"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"radiusMeters":"meter","distanceMeters":"meter","footprintAreaSquareMeters":"square meter","footprintAreaAcres":"acre"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["ECMC and Colorado DNR publish this data \"as is\" with no warranty of any kind. Verify any result with ECMC before relying on it for a transaction, a setback determination, or a seller disclosure.","Proximity is a screening signal, not a compliance determination. Rule 604 measures 2,000 ft from a Residential or High Occupancy Building Unit to a proposed location, allows substantially equivalent protections, and adds conditions inside Disproportionately Impacted Communities.","Distances are measured from the coordinate supplied, not from a parcel outline. A parcel centroid is not its footprint.","Inspections, violations (NOAVs), spills, and complaints are NOT reachable through this API. ECMC publishes them only as per-facility HTML on COGIS or as monthly bulk files, so this connector does not cover them.","Flowlines are not covered: the ECMC flow-pipes service advertises query support and returns HTTP 400 on every query, so Colorado flowline proximity cannot be answered here.","Subsurface horizontal laterals are not yet covered. A lateral can run under a parcel whose surface hole is miles away, so a zero-well answer does not mean nothing runs underneath.","Production, casing, cement, completion, and injection-pressure detail are deliberately excluded; those are ECMC COGIS scout-card fields outside this connector's purpose.","No ECMC layer carries a county name or FIPS field. County is encoded only in the API-number prefix under ECMC's own code scheme, so no county name is ever inferred here.","Overlap is tested against the bbox or radius supplied, which is not the parcel outline. Confirm a true intersection against the returned polygon geometry.","Footprint area is computed by ECMC in its native EPSG:26913 metric projection; acres are derived from it."]},{"name":"searchPermits","description":"Find pending or approved drilling applications, or docketed applications, near a point.","notes":"A curated pending/approved application slice, never all ECMC permits.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"WGS84 latitude of the parcel point being screened."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"WGS84 longitude of the parcel point being screened."},"radiusMeters":{"type":"number","exclusiveMinimum":0,"maximum":25000,"description":"Search radius in metres. Defaults to 610 m — the 2,000 ft setback in Colorado Rule 604 (2 CCR 404-1-604), measured there from a Residential or High Occupancy Building Unit to a proposed location. A radius around a supplied point is a screening signal, not a compliance determination."},"dataset":{"type":"string","enum":["permits","pendingApplications"],"description":"permits reads Form 2 / Form 2A application points; pendingApplications reads docketed spacing, setback, and OGDP polygons."},"formType":{"type":"string","enum":["form2ApprovedPermit","form2PendingPermit","form2aPendingLocation","all"],"description":"Applies to dataset permits only."},"operator":{"type":"string","maxLength":120,"description":"Case-insensitive substring of the operator name as ECMC publishes it."},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":100000},"format":{"type":"string","enum":["records","geojson"],"description":"geojson returns GeoJSON Features in records for map rendering."}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"statusDate","notes":"ECMC's FGDC metadata states a daily update frequency. Probed 2026-08-10, the facilities layer carried status_date values through 2026-08-07 while the permits layer had not moved past 2025-12-10."},"scope":"connector"},"entities":{"status":"declared","value":["drilling permit application","docketed pending application"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"radiusMeters":"meter","distanceMeters":"meter"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["ECMC and Colorado DNR publish this data \"as is\" with no warranty of any kind. Verify any result with ECMC before relying on it for a transaction, a setback determination, or a seller disclosure.","Proximity is a screening signal, not a compliance determination. Rule 604 measures 2,000 ft from a Residential or High Occupancy Building Unit to a proposed location, allows substantially equivalent protections, and adds conditions inside Disproportionately Impacted Communities.","Distances are measured from the coordinate supplied, not from a parcel outline. A parcel centroid is not its footprint.","Inspections, violations (NOAVs), spills, and complaints are NOT reachable through this API. ECMC publishes them only as per-facility HTML on COGIS or as monthly bulk files, so this connector does not cover them.","Flowlines are not covered: the ECMC flow-pipes service advertises query support and returns HTTP 400 on every query, so Colorado flowline proximity cannot be answered here.","Subsurface horizontal laterals are not yet covered. A lateral can run under a parcel whose surface hole is miles away, so a zero-well answer does not mean nothing runs underneath.","Production, casing, cement, completion, and injection-pressure detail are deliberately excluded; those are ECMC COGIS scout-card fields outside this connector's purpose.","No ECMC layer carries a county name or FIPS field. County is encoded only in the API-number prefix under ECMC's own code scheme, so no county name is ever inferred here.","The permits layer is a curated subset of pending and approved applications. Probed 2026-08-10 its 1,103 rows ran only to 2025-12-10 while the facilities layer was current to 2026-08-07. Never describe it as all ECMC permits.","receive_date is stored upstream as an MM/DD/YYYY string rather than a date, so no server-side date filter is offered; filter the returned receiveDate values instead.","The pending-applications layer publishes an operator NUMBER, not a name."]},{"name":"searchFacilities","description":"Find tank batteries, disposal wells, compressor stations, and pits within a radius.","notes":"Pits are a separate ECMC layer; facilityType all reads both.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"WGS84 latitude of the parcel point being screened."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"WGS84 longitude of the parcel point being screened."},"radiusMeters":{"type":"number","exclusiveMinimum":0,"maximum":25000,"description":"Search radius in metres. Defaults to 610 m — the 2,000 ft setback in Colorado Rule 604 (2 CCR 404-1-604), measured there from a Residential or High Occupancy Building Unit to a proposed location. A radius around a supplied point is a screening signal, not a compliance determination."},"facilityType":{"type":"string","enum":["tankBattery","uicDisposal","compressorStation","landApplication","flowlineSystem","gasProcessingPlant","pit","all"],"description":"Defaults to all, which reads the facilities and pits layers together."},"status":{"type":"string","enum":["active","abandonedLocation","closed","all"]},"operator":{"type":"string","maxLength":120,"description":"Case-insensitive substring of the operator name as ECMC publishes it."},"limit":{"type":"integer","minimum":1,"maximum":200},"format":{"type":"string","enum":["records","geojson"],"description":"geojson returns GeoJSON Features in records for map rendering."}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"statusDate","notes":"ECMC's FGDC metadata states a daily update frequency. Probed 2026-08-10, the facilities layer carried status_date values through 2026-08-07 while the permits layer had not moved past 2025-12-10."},"scope":"connector"},"entities":{"status":"declared","value":["oil and gas facility","pit"]},"pagination":{"status":"declared","value":{"style":"none","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"radiusMeters":"meter","distanceMeters":"meter"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["ECMC and Colorado DNR publish this data \"as is\" with no warranty of any kind. Verify any result with ECMC before relying on it for a transaction, a setback determination, or a seller disclosure.","Proximity is a screening signal, not a compliance determination. Rule 604 measures 2,000 ft from a Residential or High Occupancy Building Unit to a proposed location, allows substantially equivalent protections, and adds conditions inside Disproportionately Impacted Communities.","Distances are measured from the coordinate supplied, not from a parcel outline. A parcel centroid is not its footprint.","Inspections, violations (NOAVs), spills, and complaints are NOT reachable through this API. ECMC publishes them only as per-facility HTML on COGIS or as monthly bulk files, so this connector does not cover them.","Flowlines are not covered: the ECMC flow-pipes service advertises query support and returns HTTP 400 on every query, so Colorado flowline proximity cannot be answered here.","Subsurface horizontal laterals are not yet covered. A lateral can run under a parcel whose surface hole is miles away, so a zero-well answer does not mean nothing runs underneath.","Production, casing, cement, completion, and injection-pressure detail are deliberately excluded; those are ECMC COGIS scout-card fields outside this connector's purpose.","No ECMC layer carries a county name or FIPS field. County is encoded only in the API-number prefix under ECMC's own code scheme, so no county name is ever inferred here.","status_date contains future-dated values upstream, so it is surfaced verbatim and never used to compute a freshness signal.","Facility status decodes only for the codes ECMC publishes in its legend (AC, AL, AP, CL, UN); any other code is returned raw with a null label.","Offset paging is not offered because this method merges two layers and sorts the merge by distance."]},{"name":"getWellDetail","description":"Look up one Colorado well by API number with its ECMC wellbore rows and PLSS location.","notes":"Wellbore rows are one per formation or sidetrack, not per hole.","requiredParams":["apiNumber"],"inputSchema":{"type":"object","properties":{"apiNumber":{"type":"string","maxLength":24,"description":"Accepts 05-123-11605, 123-11605, or 12311605."}},"required":["apiNumber"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"statusDate","notes":"ECMC's FGDC metadata states a daily update frequency. Probed 2026-08-10, the facilities layer carried status_date values through 2026-08-07 while the permits layer had not moved past 2025-12-10."},"scope":"connector"},"entities":{"status":"declared","value":["well","wellbore"]},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["ECMC and Colorado DNR publish this data \"as is\" with no warranty of any kind. Verify any result with ECMC before relying on it for a transaction, a setback determination, or a seller disclosure.","Proximity is a screening signal, not a compliance determination. Rule 604 measures 2,000 ft from a Residential or High Occupancy Building Unit to a proposed location, allows substantially equivalent protections, and adds conditions inside Disproportionately Impacted Communities.","Distances are measured from the coordinate supplied, not from a parcel outline. A parcel centroid is not its footprint.","Inspections, violations (NOAVs), spills, and complaints are NOT reachable through this API. ECMC publishes them only as per-facility HTML on COGIS or as monthly bulk files, so this connector does not cover them.","Flowlines are not covered: the ECMC flow-pipes service advertises query support and returns HTTP 400 on every query, so Colorado flowline proximity cannot be answered here.","Subsurface horizontal laterals are not yet covered. A lateral can run under a parcel whose surface hole is miles away, so a zero-well answer does not mean nothing runs underneath.","Production, casing, cement, completion, and injection-pressure detail are deliberately excluded; those are ECMC COGIS scout-card fields outside this connector's purpose.","No ECMC layer carries a county name or FIPS field. County is encoded only in the API-number prefix under ECMC's own code scheme, so no county name is ever inferred here.","Well construction detail — casing, cement, completion, production, and injection pressure — is deliberately excluded; ECMC publishes it on the COGIS scout card.","ECMC API numbers are Colorado-only and use ECMC's own county-code scheme in the prefix."]},{"name":"getServiceInfo","description":"Report the live ECMC layers this connector queries, with schema and record counts.","notes":"The ECMC_Public folder is hidden from the ArcGIS root listing.","inputSchema":{"type":"object","properties":{"service":{"type":"string","enum":["wells","wellbores","locations","facilities","pits","permits","pendingApplications"],"description":"Omit to describe every layer this connector queries."}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"statusDate","notes":"ECMC's FGDC metadata states a daily update frequency. Probed 2026-08-10, the facilities layer carried status_date values through 2026-08-07 while the permits layer had not moved past 2025-12-10."},"scope":"connector"},"entities":{"status":"declared","value":["arcgis layer"]},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["ECMC and Colorado DNR publish this data \"as is\" with no warranty of any kind. Verify any result with ECMC before relying on it for a transaction, a setback determination, or a seller disclosure.","Proximity is a screening signal, not a compliance determination. Rule 604 measures 2,000 ft from a Residential or High Occupancy Building Unit to a proposed location, allows substantially equivalent protections, and adds conditions inside Disproportionately Impacted Communities.","Distances are measured from the coordinate supplied, not from a parcel outline. A parcel centroid is not its footprint.","Inspections, violations (NOAVs), spills, and complaints are NOT reachable through this API. ECMC publishes them only as per-facility HTML on COGIS or as monthly bulk files, so this connector does not cover them.","Flowlines are not covered: the ECMC flow-pipes service advertises query support and returns HTTP 400 on every query, so Colorado flowline proximity cannot be answered here.","Subsurface horizontal laterals are not yet covered. A lateral can run under a parcel whose surface hole is miles away, so a zero-well answer does not mean nothing runs underneath.","Production, casing, cement, completion, and injection-pressure detail are deliberately excluded; those are ECMC COGIS scout-card fields outside this connector's purpose.","No ECMC layer carries a county name or FIPS field. County is encoded only in the API-number prefix under ECMC's own code scheme, so no county name is ever inferred here.","The ECMC flow-pipes service is deliberately absent: it advertises query support and returns HTTP 400 on every query.","All layers store geometry in EPSG:26913; every query declares inSR/outSR 4326 and metric distance units explicitly."]}]},"caveats":["ECMC and Colorado DNR publish this data \"as is\" with no warranty of any kind. Verify any result with ECMC before relying on it for a transaction, a setback determination, or a seller disclosure.","Proximity is a screening signal, not a compliance determination. Rule 604 measures 2,000 ft from a Residential or High Occupancy Building Unit to a proposed location, allows substantially equivalent protections, and adds conditions inside Disproportionately Impacted Communities.","Distances are measured from the coordinate supplied, not from a parcel outline. A parcel centroid is not its footprint.","Inspections, violations (NOAVs), spills, and complaints are NOT reachable through this API. ECMC publishes them only as per-facility HTML on COGIS or as monthly bulk files, so this connector does not cover them.","Flowlines are not covered: the ECMC flow-pipes service advertises query support and returns HTTP 400 on every query, so Colorado flowline proximity cannot be answered here.","Subsurface horizontal laterals are not yet covered. A lateral can run under a parcel whose surface hole is miles away, so a zero-well answer does not mean nothing runs underneath.","Production, casing, cement, completion, and injection-pressure detail are deliberately excluded; those are ECMC COGIS scout-card fields outside this connector's purpose.","No ECMC layer carries a county name or FIPS field. County is encoded only in the API-number prefix under ECMC's own code scheme, so no county name is ever inferred here."]}