All data sources

CalGEM WellSTAR

No authcalgem

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]

Provenance

PublisherCalGEM WellSTAR

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (7)

  • searchWells

    read

    Search CA wells by operator/county/field/district/status/type/api/bbox.

    Entitieswell
    Input schema
    {
      "type": "object",
      "properties": {
        "operator": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "field": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "wellStatus": {
          "type": "string"
        },
        "wellType": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "type": {
          "type": "string"
        },
        "api": {
          "type": "string"
        },
        "bbox": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "limit": {
          "type": "number"
        },
        "offset": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  • getWellDetail

    read

    Full well record by API number.

    Required paramsapi or apiNumber or api_number
    Entitieswell
    Input schema
    {
      "type": "object",
      "properties": {
        "api": {
          "type": "string"
        },
        "apiNumber": {
          "type": "string"
        },
        "api_number": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "allOf": [
        {
          "anyOf": [
            {
              "required": [
                "api"
              ]
            },
            {
              "required": [
                "apiNumber"
              ]
            },
            {
              "required": [
                "api_number"
              ]
            }
          ]
        }
      ]
    }
  • countWells

    read

    Count wells matching criteria (no records returned).

    Entitieswell
    Input schema
    {
      "type": "object",
      "properties": {
        "operator": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "field": {
          "type": "string"
        },
        "district": {
          "type": "string"
        },
        "wellStatus": {
          "type": "string"
        },
        "wellType": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "type": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
  • searchWellsByRadius

    read

    Wells within radius (miles) of latitude/longitude.

    Required paramslatitudelongitude
    Entitieswell
    Input schema
    {
      "type": "object",
      "properties": {
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        },
        "radiusMiles": {
          "type": "number"
        },
        "limit": {
          "type": "number"
        }
      },
      "additionalProperties": false,
      "required": [
        "latitude",
        "longitude"
      ]
    }
  • searchFacilities

    read

    CalGEM facilities by operator/county/type/bbox.

    Entitiesrecord
    Input schema
    {
      "type": "object",
      "properties": {
        "operator": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "facilityType": {
          "type": "string"
        },
        "bbox": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "limit": {
          "type": "number"
        },
        "offset": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  • searchIncidents

    read

    Oil & gas incidents by operator, field, incident type/status, year, or bbox.

    Entitiesincident
    Input schema
    {
      "type": "object",
      "properties": {
        "operator": {
          "type": "string"
        },
        "year": {
          "type": "number"
        },
        "field": {
          "type": "string"
        },
        "incidentType": {
          "type": "string"
        },
        "incidentStatus": {
          "type": "string"
        },
        "bbox": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "limit": {
          "type": "number"
        },
        "offset": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }
  • searchNotices

    read

    Notices of intent by operator, county, type, or status. County maps to California API prefixes.

    Entitiespermit
    Input schema
    {
      "type": "object",
      "properties": {
        "operator": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "noticeType": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "limit": {
          "type": "number"
        },
        "offset": {
          "type": "number"
        }
      },
      "additionalProperties": false
    }