Know your data sources.

Alaska Oil and Gas Conservation Commission well registry. North Slope (Arctic Slope ~8.1K wells) + Cook Inlet Basin (~1.75K) operator side — Hilcorp, ConocoPhillips, BP/ARCO heavy. - searchWells (~10.3K) ⭐ filter area (basin)/operator/status/wellClass/field/offshoreOnly. Pass bottomHole=true for bottom-hole locations. - searchBottomHoles ⭐ alias for the paired Well_Bottom_Hole_Location service - getWellByApi, listLayers, getServiceInfo upstream quirks: AK is borough-based (no county column) — use area for basin scoping. Native CRS EPSG:3338; service reprojects to 4326. CurrentStatus has 30+ descriptive values (Plugged & Abandoned 3.8K, Oil well single 3.4K, Water alt gas injection 976). maxRecordCount=2000.

Alabama State Oil & Gas Board well inventory, bottom-hole locations, offshore platforms, lease blocks, and field units via map.ogb.state.al.us. - searchWells ⭐ ~2.89K wells with permit/API/operator/status/wellType/county - searchBottomHoles ~409 lean BH points (no operator) - searchOffshorePlatforms ~35 with operator/type/structure/tract - getWellByPermit, getServiceInfo §0: build-plan said "layer 39" (MS data on the same MapServer); AL wells live at layer 28. WellStatus is a code, TypeDesc is the STATUS description; WellType = product code, StatusDesc = TYPE description. Mobile + Escambia + Baldwin = 81% of records. CRS 102100; outSR=4326.

Arkansas Oil & Gas Commission well inventory, Smackover-Norphlet lithium-brine lease polygons, and historical pipelines via the Arkansas State GIS Office. - searchWells ⭐ ~38.2K wells with permit/operator/welltype/status/county/section - searchLithiumLeasedAreas ⭐ ~7 lithium-brine polygons (Standard Lithium + ExxonMobil) - searchPipelines ~719 USGS-1986 historical polylines - getWellByPermit, getServiceInfo §0: build-plan said Location/FeatureServer — has only GNIS names, NO O&G. Canonical wells at Utilities/FeatureServer/5. Fields lowercase (operatorname); counties UPPERCASE (UNION 7.1K, 19%). wellstatus has "ex" typo alongside "EX". CRS 26915; outSR=4326.

Arizona Oil & Gas Conservation Commission inventory: 1,241 well points plus sedimentary-basin and county-subdivision polygons from a 2023 snapshot. searchWells filters API, name, operator, county, status, or type; getWellsInBBox handles bbox/radius; polygon methods return GeoJSON. Well data is FeatureServer layer 7; layers 1-6 are generalized overlays, not wells. Status/type filters are case-insensitive because source casing varies. getCounties returns Census subdivisions, not the 15 counties. Native CRS is WGS84.

British Columbia Energy Regulator — oil & gas well data for BC (Montney play, WCSB). Public ArcGIS REST, no auth. METHODS: searchBCWells, getBCWellDetail, searchAllInternationalWells CRITICAL USAGE RULES: 1. Well IDs are BC-specific authority numbers (not US API format) 2. Use field or formation for play names like Montney; in BC this primarily matches well-area/play labels and sometimes well names 3. searchAllInternationalWells is a cross-jurisdiction sweep (currently BC only; expands as more jurisdictions wire in) 4. bbox params are [minLon, minLat, maxLon, maxLat]

California Geologic Energy Management Division (CalGEM) WellSTAR — wells, facilities, incidents, notices. Public ArcGIS REST, no auth. WELLS: searchWells, getWellDetail, countWells, searchWellsByRadius FACILITIES / REGULATORY: searchFacilities, searchIncidents, searchNotices CRITICAL USAGE RULES: 1. API numbers are 8-10 digits (California format) 2. Use searchWellsByRadius for geographic queries (radiusMiles default 5) 3. searchWells accepts intuitive aliases like { status: 'active', type: 'oil' } and maps them to CalGEM codes 4. searchNotices supports county by matching county API prefixes and returns most recent notices first 5. bbox params are [minLon, minLat, maxLon, maxLat]

Clearfork Intelligence — curated Texas & New Mexico oil & gas well data, TX drilling permits, and monthly production history with enrichment (aggregated production stats, SB-1150 "zombie well" exposure, canonical well IDs, radius + batch lookup). A cleaned commercial layer complementing the public rrc/nmocd connectors. AUTH: PAID Bearer token (key format cfork_live_...). Set CLEARFORK_BEARER_TOKEN. Requires an Operator ($249/mo) or Enterprise ($499/mo) plan; the permits methods are Enterprise-only. getServiceInfo works without a key (hits the public /health endpoint).

Colorado ECMC (formerly COGCC). DJ Basin / Wattenberg / Piceance operator-side. - searchWells (~120K) ⭐ filter county/operator/status/citingType/fieldName - searchPermits ⭐ Citing_Typ NOTICE+PLANNED on Well Spots - getWellByApi, searchPits (~13.7K), searchDirectionalBottomHoles (~38.1K), getServiceInfo Spec drift: searchSpills + searchSetbacks DROPPED — no Feature Services. Replaced with searchPits + searchDirectionalBottomHoles. upstream quirks: Authoritative AGOL is martinwi-owned COGCC_VIEW (same org as SLB). NO County text column — only API_County FIPS (123=Weld, 045=Garfield). Facil_Stat 2-letter codes (PR/PA/AC). Top operators: NOBLE (9.9K), KERR MCGEE (9K), PDC ENERGY (6.5K).

Real-time drilling analytics and monitoring platform for oil and gas operations. Provides access to well information, rig status, drilling data, and completion records from Corva's Info and Data APIs. AUTHENTICATION: Supports two methods: 1. API Key: Provide apiKey/CORVA_API_KEY 2. Email/Password: Provide email + password (creates JWT token automatically)

Pan-EU harmonized offshore oil & gas — OGC WFS 2.0.0, no auth. 18 EU countries (Croatia, Cyprus, Denmark, Faroe Islands, France, Germany, Greece, Ireland, Italy, Latvia, Malta, Montenegro, Netherlands, Norway, Poland, Portugal, Spain, UK). Annual refresh — breadth filler; prefer sodir/nsta for authoritative national data. Layers: - hydrocarbons (~28.5K wells) ⭐ status/purpose/content/country filters - platforms (~1.6K) ⭐ currentStatus/category/primaryProduction - pipelines (~3.9K) ⭐ medium/status/country - activelicenses (~1.3K polygons) type/country

Florida Department of Environmental Protection — permitted O&G wells plus environmental cleanup sites and state conservation lands, all folded into one connector. - searchOilGasWells ⭐ 1,477 permitted wells with company, county UPPERCASE, status (DRY HOLE/P&A, PROD, P&A, INJ, SWD) - searchEnvironmentalSites ⭐ 10,245 DEP cleanup sites — PETRO/BROWN/PFAS/SUPER/OTHCU - searchManagedLands ⭐ typed: brownfield (620) | aquatic-preserve (44) | conservation-land (3,215) - getWellByPermit, getServiceInfo §0 spec drift: FNAI SFWMD endpoint 403's — replaced with publicly readable FDEM AGOL FS/43 (same FNAI lineage). OIL_WELLS native CRS EPSG:6439 (FL Albers HARN). CLEANUP_SP has only numeric county ID. AQUATIC_PRESERVES uses plural COUNTIES.

Illinois State Geological Survey (ISGS) ILOIL well registry plus oil/gas/storage field polygons and waterflood-area boundaries via maps.isgs.illinois.edu. - searchWells ⭐ ~207K wells with API, status code+text, operator, formation, depth - searchOilGasFields ⭐ ~1K canonical 2024 unified oil + gas + gas-storage polygons (or ~550 legacy) - getWellByApi single well lookup, searchWaterfloodAreas, getServiceInfo §0 spec drift: brief listed Oil_Gas_GasStor_Fields_2023 — that service is 404. Canonical service is _2024. Wells layer is at index 8 of Wells/MapServer (NOT 0). STATUS column has 100+ codes; STATUS_TEXT has 100+ descriptive variants. Legacy service uses upper-snake fields, 2024 uses camelCase. Native CRS 102100; outSR=4326.

Indiana DNR oil and gas wells + natural-gas pipelines plus DNR-managed lands (nature preserves, recreation sites, forestry tracts) via the gisdata.in.gov state Hub. - searchWells ⭐ ~78.3K wells with county/lease/permit/status — no operator on this layer - searchPipelines ⭐ ~215 interstate + intrastate gas pipelines with operator names - searchManagedLands ⭐ typed: nature-preserve | recreation-site | forestry-tract - getWellByIgsId, getServiceInfo §0 spec drift: brief listed portal.igs.indiana.edu as primary; rich registry actually lives on gisdata.in.gov state Hub. maps.indiana.edu root is HTML 404. operator_name on OilAndGasWells is ALWAYS NULL upstream. CRS varies (102100/4269/26916); outSR=4326.

Kansas Geological Survey (KGS) — oil and gas wells (~515K), field polygons (~8K), and Class II UIC injection wells (~49K). - searchWells ⭐ 515,517 wells with operator, county Title Case, status, wellType, formation - searchOilGasFields ⭐ 8,089 field polygons (Active/Abandoned, Oil/Gas/Oil and Gas) - searchClassIIWells ⭐ 49,381 UIC Class II injection wells (EOR/SWD) - getWellByApi, getServiceInfo §0 spec drift: Hub kgs-gis-data-and-maps-ku is discovered via DCAT feed; underlying FS on services2.arcgis.com tenant ZOdjAzAQ2B0f85zi. STATUS column has 100+ codes (incl P&A suffix variants); WELL_TYPE separate. API_NUMBER dashed; API_NUM_NODASH 14-digit. CRS 102100; outSR=4326.

Kentucky Geological Survey oil and gas well-records repository — every Appalachian and Illinois Basin KY well in one HTTP call. - searchWells (~144.9K) ⭐ filter county/operator/boreType/resultSymbol (D&A/OIL/GAS/CBM)/basinCode/formation/pool - searchWellsByOperator ⭐ + searchWellsByCounty ⭐ — convenience wrappers exploiting the 1M page cap - getWellByApi (api OR record_number lookup), getServiceInfo §0 verified: maxRecordCount=1,000,000 confirmed — all 144,902 wells returned in one query. Native CRS EPSG:6473 (KY Single Zone); outSR=4326 reprojects on the wire. KY is 99% vertical drilling (143K V vs 1.5K H). Top counties: Henderson 6.9K, Cumberland 6.6K, Daviess 6.3K, Pike 6.3K. Top result symbols: D&A 45.7K, OIL 39.2K, GAS 28.8K, LOC 20K.

Louisiana SONRIS / DNR (now DCE) oil & gas. No auth. - searchWells (~245K) ⭐ filter by parish, operator, status (LEGEND_DES), product - searchSaltDomes (174) ⭐ LA-specific — caverns, sour gas risk, SPR - searchFields (~11K polygons), searchInjectionWells (~4.5K), getWellByApi, getServiceInfo upstream quirks: native sonris-www server is 404, working data is on AGOL mirrors. Well attributes are 10-char-truncated (WELL_STATU/LEGEND_DES). PARISH_NAM stored UPPERCASE. SONRIS production DB has no public API — wells include sonrisLink for browser-session deep dive.

Michigan EGLE oil and gas surface and bottom-hole locations, directional starts, and gas-storage field polygons via EGLE MiStar + DataMiner ArcGIS services. - searchSurfaceHoles ⭐ ~92.4K wells (DataMinerWells2; code WellStatus) - searchBottomHoles ⭐ ~96.6K — operator (co_name), formation (deep_fm), depth - searchGasStorageFields ⭐ ~61 storage-field polygons - searchDirectionalStarts (~95.3K), getWellByApi, getServiceInfo quirks: surface uses code WellStatus (PLA/PR/TP/ACT/SI/TA); bottom-hole uses descriptive ("Plugging Approved", "Producing"). No county column — use bbox/near. CRS 102100; outSR=4326. maxRecord=1000.

Mississippi Oil & Gas Board well-surface locations, onshore and offshore pipelines, and offshore platforms via FracTracker-curated AGOL services. - searchWells ⭐ ~8.1K canonical wells with API/operator/status/county/field/township - searchPipelines ⭐ ~3.5K (712+727 onshore lean + 2K offshore BSEE-style) - searchOffshorePlatforms ⭐ ~617 platforms with COMPLEX_ID, INSTALL_DA, REMOVAL_DA - getWellByApi, getServiceInfo §0 spec drift: build-plan endpoint (Mississippi_NEW2) has NO structured wells layer — its "Merge 7" point layer (6,557 KML-imported records) only exposes PopupInfo HTML strings. Canonical structured wells live at Mississippi_Update_4821/0. Native CRS already EPSG:4326. CountyName UPPERCASE.

Montana Board of Oil and Gas Conservation (BOGC) — wells (~42K), directional well paths (~4.1K), and DNRC Mineral Mgmt Bureau active state O&G leases (~1.2K). - searchWells ⭐ 41,960 wells with operator, status (P&A Approved, Producing, Shut In), type (Oil, Gas, CBM, Injection) - searchActiveLeases ⭐ 1,186 state O&G leases with County UPPERCASE, customer, primary-term flag - searchWellPaths ⭐ 4,113 directional well paths with formation - getWellByApi, getServiceInfo §0 spec drift: MBMG (state geological survey) Hub returns 403 — DROPPED. BOG_Wells layer has NO County column — county filter on wells must use bbox or PLSS Township/Range. APIWellNumber stored 14-digit unpacked. CRS varies (4269/32100); outSR=4326 works.

North Dakota DMR (Bakken/Three Forks) oil & gas. AGOL mirror of NDIC public well data; no auth. - searchWells (~25.5K) ⭐ filter by county, operator, status (A/PA/DRY/Confidential), well_type, township/range/section - searchPermits ⭐ wells in LOC/DRL/PNC/EXP permit states - getWellByApi, searchHorizontalLegs (~15.8K Bakken laterals), searchProductionByField, searchSpills, getServiceInfo upstream quirks: native dmr.nd.gov fee-services 401, working data is on AGOL sbogan_worldmap mirror. county UPPERCASE, status enum opaque codes (A/PA/DRY/Confidential), api lossy on production layer (use api_no on wells), horizontal legs only have linekey (api_LATn). Spills come from the FracTracker mirror — 2014-era extract, no live updates.

Australian Commonwealth offshore petroleum wells and seismic surveys (NOPTA / NOPSEMA). Find wells in Carnarvon/Browse/Bonaparte/Otway/Gippsland basins, search 2D and 3D seismic survey footprints. Production volumes not included — permanently confidential under Australian Regulations 8.02(3)/10.02(3). CC-BY 4.0.

New York DEC Division of Mineral Resources — oil and gas wells (Allegany / Cattaraugus / Chautauqua dominant) plus surface mining permits (sand and gravel, bluestone, limestone). - searchWells (~47.4K) ⭐ filter county/operator/generalWellType/wellTypeCode/status/slant/formation - searchMines (~6.1K) ⭐ filter county/commodity/status/permittee - getWellByApi (API_WELLNO 14-digit), getMineById (MINEID), getServiceInfo §0 caught: WELL_TYPE / WELL_STATUS use 2-letter codes (OD/GD/IW/PA/AC); GENERALWELLTYPE / GENERALWELLSTATUS rollups available. Native CRS EPSG:26918 (NAD83 UTM 18N); outSR=4326 reprojects. Mines COMMODITY values are space-padded fixed-width — handler trims. Mines dates stored MM/DD/YYYY (NOT epoch ms). NY env folded into this connector per Batch L plan.

New Zealand petroleum permits, wells, and geophysical surveys from NZ Petroleum & Minerals (MBIE). Covers active prospecting, exploration, and mining permits — primarily Taranaki Basin. 1,267 wells and 38 active permits. Production volumes are published separately by MBIE (PDF/Excel); this connector covers spatial and regulatory data only.

Oklahoma Corporation Commission (OCC) live ArcGIS REST. No auth. 26 methods, 49 layers. DOMAINS: - Wells: searchWells, getOrphanWells, getStateFundsWells, getWellLogs, getCompletions, getHorizontalLaterals, getUICWells. - Permits: getPermits (ITD). - Units/Rules: getDrillingUnits, getFieldRules. - Seismicity: getInducedSeismicity({zone}). - Surface: getFacilities, getOilGasIncidents, getGasStorage, getPSTTanks/Releases. - Water: getHydrology, getBaseTreatableWater, getPublicWaterSupplyWells/Intakes, getGroundwaterWells. - Geology/Cadastral: getSedimentaryBasins, getCadastral, getDistricts. - Generic: queryLayer({layer,...}) for any listLayers() key. Returns {features, geojson, total}. geojson → patchops_addMapLayer. Page cap 2000. Production volumes at OK Tax Commission.

Ohio ODNR DOGRM. Marcellus + Utica operator side — Eclipse, Encino, Ascent, EAP heavy. - searchWells (~242K) ⭐ filter county/operator/status/wellType (V/H/D/O)/uticaOnly/marcellusOnly/orphanOnly - searchHorizontalWells ⭐ Utica/Marcellus laterals; asLines=true returns ~4.3K polylines - getWellByApi, searchWellPads, searchDrillingUnits, searchOilGasFields (~3K), getServiceInfo upstream quirks: WL_CNTY UPPERCASE on wells; County Title Case on pads. SLANT V/H/D/O. WL_STATUS_DESC is descriptive text. Utica_Shale/Marcellus_Shale 0/1. maxRecordCount=1000.

Pennsylvania DEP Bureau of Oil & Gas Management. PA's quirk: O&G regulator lives under DEP. - searchWells (~25K Unconv + ~199K Conv) ⭐ filter county/operator/status/wellType/wellConfig/wellCategory - searchPermits ⭐ wells with PERMIT_DATE in window (default unconv, last 365d) - getWellByApi, searchOrphanedWells (~27K), searchViolationsAndComplaints, getServiceInfo upstream quirks: PA does NOT use 14-digit API — wells keyed by PERMIT_NUMBER like '003-22621'. WELL_STATUS: Active / Plugged OG Well / Operator Reported Not Drilled / DEP Orphan List. WELL_CONFIG: Vertical (199K conv) / Horizontal (23K unconv) / Deviated. DEP does NOT publish violations Feature Service — Complaints (~39K) used as proxy. Production NOT a Feature Service (XML only) — dropped.

Geological Survey of Queensland — ~190k datasets: well completion reports (16k+), well proposals, hydraulic-fracturing reports, petroleum production/reserves reports, boreholes, seismic, geochemistry, magnetic/radiometric/gravity grids. No-auth CKAN 3. METHODS: packageSearch, packageShow, resourceShow, searchPetroleumReports, searchBoreholes, listOrganizations, listGroups, getServiceInfo RULES: 1. Vocab values are full URIs (linked.data.gov.au/def/...); fq accepts `:*petroleum` shorthand. 2. Single org (GSQ), single group (geoscience). 3. Pagination caps at 1000 rows; use `start`. 4. `type`: report | borehole | map-collection | geochemistry | seismic | magnetic | radiometric | electromagnetic | gravity | dataset | gravity-gradiometry | spectral | magnetotelluric | electrical.

Texas RRC oil & gas regulatory data (Postgres/PostGIS). Wells, production, pipelines, permits, inspections, violations, gas plants, fields, orgs. RULES: 1. No auth. 2. searchWells/searchWellsByArea for discovery. county is NAME (e.g. "MIDLAND") — auto-resolved. 3. Nearby: flat latitude/longitude/radius_meters. 4. getWellDetail when API known. getWellProduction for lease monthly. 5. Pipeline lines: getPipelineGeoJSON or searchGisPipelines + patchops_addMapLayer({geojson}). 6. searchPipelineSegments/getPipelinesNearLocation are DISCOVERY only — do NOT map centroids as points. 7. Flow: getPipelinesNearLocation → getPipelineGeoJSON({segment_ids:[id]}). 8. NEVER simulate pipeline routes. Stop at discovery if geometry missing. 9. searchGisSurveys + patchops_addMapLayer for parcel polygons.

Norwegian Continental Shelf (NCS) open data — 9,765 wellbores, 142 fields, 645 discoveries, 1,809 licences, 82 pipelines, 1,215 facilities, 5,008 seismic surveys. - searchWellbores ⭐ operator/status/purpose/content/field/area/date - getWellbore ⭐ by name (e.g. '33/12-1') or NPDID - searchFields ⭐ Producing/Approved for production/Shut down - searchDiscoveries ⭐ status, HC type, operator, year range - searchLicences ACTIVE/INACTIVE polygons - searchPipelines medium (OIL/GAS), phase, facility - searchFacilities platforms, FPSOs, subsea — kind/phase - searchSeismicSurveys 2D/3D/4D acquisition areas - getWellboreFormationTops lithostratigraphy per wellbore - getWellboreDST drill stem tests per wellbore - getFieldReserves oil/gas/NGL/condensate reserves (multi-vintage)

Utah DOGM — O&G regulator. Uinta Basin operator side (Crescent / Ovintiv / KODA). - searchWells ⭐ ~40K surface wells with operator/county/status/cumulative - searchBottomHoles ⭐ ~33K bottomhole locations (deviated wells) - searchWellPaths ~12.5K directional drilling polylines - getWellByApi single-well lookup by 10-digit API upstream quirks: AGOL services.arcgis.com/ZzrwjTRez6FJiOq4 owner OGMGIS_utahDNR. Surf County is UPPERCASE STRING ('DUCHESNE'); BottomHole County is INTEGER code (Duchesne=7 / Uintah=24 / San Juan=19). Paths layer has only API + ConstructStatus (no operator/county). O&G permits are NOT a Feature Service — searchPermits dropped; APD-status wells (1772) are the substitute via searchWells.

Virginia Department of Energy (ex-DMME) — coalbed methane / oil & gas wells, 54.6K SWVA drilling grids, and statewide mineral mining permits. - searchOilGasWells ⭐ active (8.6K) | permittedUndrilled (208) | plugged (1.97K) via wellLayer - searchHorizontalGrids ⭐ 54.6K SWVA 20-acre drilling grid polygons - searchMineralMines ⭐ active (450) | released (1.78K). Filter mineralType (OP/QU/UG) - getWellByFiNo (cross-layer lookup), getServiceInfo §0 caught: Legacy dmme.virginia.gov DEAD — public surface is energy.virginia.gov. Geothermal/8 (NGDS, 1.3K) duplicate of DGO_wells — DROPPED. 73% CBM (Coalbed/Pipeline + Coal Bed). Counties UPPERCASE (BUCHANAN/DICKENSON/WISE 88%). Native CRS EPSG:6591; outSR=4326 reprojects.

Wyoming WOGCC. Powder River + Niobrara + Greater Green River — CBM legacy + modern shale. - searchWells (~68.7K) ⭐ filter county/operator/status/wellClass/twp/rge/horizontalOnly - searchPermits ⭐ STATUS in (AP, NI) on Wells layer (no separate APD service) - getWellByApi, searchHorizontalLegs (~28K BH vectors), searchPluggedAndAbandoned (~61K), getServiceInfo Spec drift: gis.wogcc.wyo.gov DNS dead. WOGCC pits + APDs not Feature Services. Replacements: searchPluggedAndAbandoned + STATUS-coded permit filtering. upstream quirks: COUNTY integer FIPS (5=Campbell 18.3K wells). STATUS 2-letter (PR/PA/SI/TA/AI/FL). maxRecordCount=1000. BH layer = horizontal lateral polylines.