Sign up
All data sources

IL State Geological Survey

No authil-isgs

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.

energywellsillinoisil-isgsillinois-basingas-storagestate-geological-surveyoil-and-gas
Get this contract as JSONConnect this source →

Provenance

PublisherIL State Geological Survey
API basehttps://maps.isgs.illinois.edu/arcgis/rest/services/ILOIL

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (5)

  • searchWells

    read

    Illinois oil and gas wells (~207K). Filter operator, status (code or text), formation, depth, bbox.

    Entitieswell
    Input schema
    {
  "type": "object",
  "properties": {
    "apiNumber": {
      "type": "string"
    },
    "permitNumber": {
      "type": "string"
    },
    "operator": {
      "type": "string",
      "examples": [
        "Continental"
      ]
    },
    "farmName": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "statusText": {
      "type": "string",
      "examples": [
        "Oil Producer"
      ]
    },
    "formation": {
      "type": "string"
    },
    "maxTotalDepth": {
      "type": "number"
    },
    "minTotalDepth": {
      "type": "number"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "near": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lon": {
          "type": "number"
        },
        "radiusMiles": {
          "type": "number"
        }
      },
      "required": [
        "lat",
        "lon",
        "radiusMiles"
      ],
      "additionalProperties": false
    },
    "limit": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

    STATUS code (OIL/OILP/DAP) and STATUS_TEXT descriptive both filterable.

  • searchOilGasFields

    read

    Field boundary polygons. Filter fieldName, fieldType (OIL/GAS/GAS STORAGE), bbox.

    Entitiesfield
    Input schema
    {
  "type": "object",
  "properties": {
    "fieldName": {
      "type": "string"
    },
    "fieldType": {
      "type": "string",
      "examples": [
        "GAS STORAGE"
      ]
    },
    "legacy": {
      "type": "boolean"
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "near": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lon": {
          "type": "number"
        },
        "radiusMiles": {
          "type": "number"
        }
      },
      "required": [
        "lat",
        "lon",
        "radiusMiles"
      ],
      "additionalProperties": false
    },
    "limit": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

    legacy=true uses ~550 polygons; default is canonical 2024 (~1K polygons).

  • getWellByApi

    read

    Single well lookup by API_NUMBER (12-digit).

    Required paramsapi
    Entitieswell
    Input schema
    {
  "type": "object",
  "properties": {
    "api": {
      "type": "string",
      "examples": [
        "120010000200"
      ]
    },
    "apiNumber": {
      "type": "string"
    },
    "api_number": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "required": [
    "api"
  ]
}

  • searchWaterfloodAreas

    read

    Waterflood (secondary-recovery) area boundary polygons.

    Entitiesrecord
    Input schema
    {
  "type": "object",
  "properties": {
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "near": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lon": {
          "type": "number"
        },
        "radiusMiles": {
          "type": "number"
        }
      },
      "required": [
        "lat",
        "lon",
        "radiusMiles"
      ],
      "additionalProperties": false
    },
    "limit": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

  • getServiceInfo

    read

    Schema, record counts, and enum values for all 4 services (IL State Geological Survey).

    Entitiesmetadata
    Input schema
    {
  "type": "object",
  "properties": {
    "service": {
      "type": "string"
    }
  },
  "additionalProperties": false
}