Provenance
Freshness & coverage
Methods (5)
searchWells
readKY oil and gas wells (~144.9K). Filter county/operator/boreType/resultSymbol/basinCode.
EntitieswellInput schema
{ "type": "object", "properties": { "county": { "type": "string", "examples": [ "Pike" ] }, "operator": { "type": "string" }, "boreType": { "type": "string", "examples": [ "H" ], "oneOf": [ { "type": "string", "enum": [ "H" ] }, { "type": "string", "enum": [ "V" ] }, { "type": "string", "enum": [ "D" ] } ] }, "resultSymbol": { "type": "string" }, "basinCode": { "type": "string" }, "formation": { "type": "string" }, "pool": { "type": "string" }, "pluggedOnly": { "type": "boolean" }, "unpluggedOnly": { "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 }maxRecordCount=1M — entire state returnable in one call. KY is 99% vertical.
searchWellsByOperator
readEvery well an operator has worked. Operator stored space-padded — handler trims.
Required paramsoperatorEntitiesoperator, wellInput schema
{ "type": "object", "properties": { "operator": { "type": "string", "examples": [ "EQUITABLE PRODUCTION" ] }, "county": { "type": "string" }, "format": { "oneOf": [ { "type": "string", "enum": [ "records" ] }, { "type": "string", "enum": [ "geojson" ] } ] }, "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" }, "boreType": { "oneOf": [ { "type": "string", "enum": [ "H" ] }, { "type": "string", "enum": [ "V" ] }, { "type": "string", "enum": [ "D" ] } ] }, "resultSymbol": { "type": "string" }, "basinCode": { "type": "string" }, "formation": { "type": "string" }, "pool": { "type": "string" }, "pluggedOnly": { "type": "boolean" }, "unpluggedOnly": { "type": "boolean" } }, "additionalProperties": false, "required": [ "operator" ] }searchWellsByCounty
readEvery well in a KY county. County names mixed-case — handler matches case-insensitively.
Required paramscountyEntitieswellInput schema
{ "type": "object", "properties": { "county": { "type": "string", "examples": [ "Henderson" ] }, "operator": { "type": "string" }, "format": { "oneOf": [ { "type": "string", "enum": [ "records" ] }, { "type": "string", "enum": [ "geojson" ] } ] }, "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" }, "boreType": { "oneOf": [ { "type": "string", "enum": [ "H" ] }, { "type": "string", "enum": [ "V" ] }, { "type": "string", "enum": [ "D" ] } ] }, "resultSymbol": { "type": "string" }, "basinCode": { "type": "string" }, "formation": { "type": "string" }, "pool": { "type": "string" }, "pluggedOnly": { "type": "boolean" }, "unpluggedOnly": { "type": "boolean" } }, "additionalProperties": false, "required": [ "county" ] }getWellByApi
readSingle well lookup by API_Number (14-digit) OR record_number (KGS primary id).
EntitieswellInput schema
{ "type": "object", "properties": { "api": { "type": "string" }, "apiNumber": { "type": "string" }, "api_number": { "type": "string" }, "recordNumber": { "type": "number", "examples": [ 12345 ] }, "record_number": { "type": "number" } }, "additionalProperties": false }API_Number ~30% NULL on legacy KY wells — record_number is more reliable.
getServiceInfo
readSchema, record count, max-page cap, enum values, §0 probe notes.
EntitiesmetadataInput schema
{ "type": "object", "properties": {}, "additionalProperties": false }
