VA Department of Energy — Oil & Gas + Horizontal Grids + Mining

Methods (5)

• searchOilGasWells

  read

  Virginia oil and gas wells. wellLayer: active|permittedUndrilled|plugged. Filter county/operator.

  Entitieswell
  Input schema

  {
    "type": "object",
    "properties": {
      "wellLayer": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "active"
            ]
          },
          {
            "type": "string",
            "enum": [
              "permittedUndrilled"
            ]
          },
          {
            "type": "string",
            "enum": [
              "plugged"
            ]
          }
        ]
      },
      "county": {
        "type": "string",
        "examples": [
          "BUCHANAN"
        ]
      },
      "operator": {
        "type": "string"
      },
      "operationType": {
        "type": "string"
      },
      "productionStatus": {
        "type": "string"
      },
      "quadrangle": {
        "type": "string"
      },
      "fiPrefix": {
        "type": "string"
      },
      "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
  }

  Counties UPPERCASE. operationType: Coal Bed / Gas / Oil / Horizontal Gas.

• searchHorizontalGrids

  read

  SWVA 20-acre horizontal drilling grid polygons (~54.6K). Filter Grid_Id or FID_Region.

  Entitiesformation
  Input schema

  {
    "type": "object",
    "properties": {
      "gridId": {
        "type": "string"
      },
      "regionFid": {
        "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
  }

• searchMineralMines

  read

  VA mineral mining permits. status: active|released. Filter mineralType (OP/QU/UG).

  Input schema

  {
    "type": "object",
    "properties": {
      "status": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "active"
            ]
          },
          {
            "type": "string",
            "enum": [
              "released"
            ]
          }
        ]
      },
      "mineName": {
        "type": "string"
      },
      "mineralType": {
        "type": "string",
        "examples": [
          "QU"
        ]
      },
      "countyCode": {
        "type": "string"
      },
      "applicationType": {
        "type": "string"
      },
      "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
  }

  Permits use 3-letter codes for county/inspector/mineral type — denormalized.

• getWellByFiNo

  read

  Single well lookup by FiNo (e.g. "BU-12345"). Defaults to all 3 well layers.

  Required paramsfiNo

  Entitieswell
  Input schema

  {
    "type": "object",
    "properties": {
      "fiNo": {
        "type": "string",
        "examples": [
          "PW-0004"
        ]
      },
      "wellLayer": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "active"
            ]
          },
          {
            "type": "string",
            "enum": [
              "permittedUndrilled"
            ]
          },
          {
            "type": "string",
            "enum": [
              "plugged"
            ]
          }
        ]
      }
    },
    "additionalProperties": false,
    "required": [
      "fiNo"
    ]
  }

• getServiceInfo

  read

  Schema, record counts, max-page caps, enum values, §0 probe notes for any of 6 services.

  Entitiesmetadata
  Input schema

  {
    "type": "object",
    "properties": {
      "service": {
        "type": "string",
        "examples": [
          "activeWells"
        ]
      }
    },
    "additionalProperties": false
  }