Sign up
All data sources

TWDB Texas Water Wells

No authtwdb

Texas Water Development Board groundwater data. Public ArcGIS REST FeatureServer, no auth. Layers: - sdr (~680k Submitted Driller's Reports — primary) - gwdb (~143k curated Groundwater Database sites with aquifers + water levels) - plugging (~242k Plugging Reports) - bracs (~89k brackish wells with geophysical logs) Owner names redacted by default; pass includeOwner: true only when explicitly requested. Counties returned in Title Case. Use bbox or near for spatial filters.

water-wellstexasdepthaquifertx-twdbsdrgwdbgroundwatermajor-aquiferminor-aquiferfreshwater
Get this contract as JSONConnect this source →

Provenance

PublisherTWDB Texas Water Wells
API basehttps://services.twdb.texas.gov/arcgis/rest/services/Public

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (12)

  • searchWells

    read

    Search SDR water wells. Filters: county, bbox, proposedUse, depth, drilledAfter/Before.

    Input schema
    {
  "type": "object",
  "properties": {
    "county": {
      "type": "string",
      "examples": [
        "Travis"
      ]
    },
    "counties": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "proposedUse": {
      "type": "string",
      "examples": [
        "Domestic"
      ]
    },
    "wellType": {
      "type": "string"
    },
    "drilledAfter": {
      "type": "string"
    },
    "drilledBefore": {
      "type": "string"
    },
    "minDepthFt": {
      "type": "number"
    },
    "maxDepthFt": {
      "type": "number"
    },
    "hasInjuriousWaterQuality": {
      "type": "boolean"
    },
    "limit": {
      "type": "number",
      "examples": [
        200
      ]
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    },
    "verbose": {
      "type": "boolean"
    },
    "includeOwner": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

    Auto-paginates 2000/page up to limit (default 500, hard cap 50000).

  • getWellsNearPoint

    read

    Radius search for SDR wells (TWDB Texas Water Wells). radiusMiles 0.1-50. Sorted nearest-first.

    Required paramslatlon
    Input schema
    {
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "examples": [
        31.95
      ]
    },
    "lon": {
      "type": "number",
      "examples": [
        -102.08
      ]
    },
    "radiusMiles": {
      "type": "number",
      "examples": [
        5
      ]
    },
    "proposedUse": {
      "type": "string"
    },
    "minDepthFt": {
      "type": "number"
    },
    "maxDepthFt": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    },
    "verbose": {
      "type": "boolean"
    },
    "includeOwner": {
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "required": [
    "lat",
    "lon",
    "radiusMiles"
  ]
}

  • getWellById

    read

    Fetch one SDR record by tracking number. includeOwner gates PII fields.

    Required paramstrackingNumber
    Input schema
    {
  "type": "object",
  "properties": {
    "trackingNumber": {
      "type": "string",
      "examples": [
        "1234567"
      ]
    },
    "includeOwner": {
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "required": [
    "trackingNumber"
  ]
}

  • getDepthStatistics

    read

    Server-side depth percentiles (p10/25/50/75/90). Optional groupBy proposedUse|wellType|decade.

    Input schema
    {
  "type": "object",
  "properties": {
    "county": {
      "type": "string",
      "examples": [
        "Midland"
      ]
    },
    "counties": {
      "type": "array",
      "items": {
        "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
    },
    "groupBy": {
      "type": "string",
      "examples": [
        "proposedUse"
      ],
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "wellType"
          ]
        },
        {
          "type": "string",
          "enum": [
            "proposedUse"
          ]
        },
        {
          "type": "string",
          "enum": [
            "decade"
          ]
        }
      ]
    }
  },
  "additionalProperties": false
}

  • getCountyCounts

    read

    Statewide SDR well counts and median depth grouped by county.

    Entitieswell
    Paginationnone
    Input schema
    {
  "type": "object",
  "properties": {
    "proposedUse": {
      "type": "string",
      "examples": [
        "Domestic"
      ]
    },
    "drilledAfter": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

  • getPluggingReports

    read

    Plugging Reports layer. Filter by county, bbox, near, pluggedAfter/Before.

    Input schema
    {
  "type": "object",
  "properties": {
    "county": {
      "type": "string",
      "examples": [
        "Reeves"
      ]
    },
    "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
    },
    "pluggedAfter": {
      "type": "string"
    },
    "pluggedBefore": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    },
    "includeOwner": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

  • searchGwdbSites

    read

    Curated GWDB groundwater wells (TWDB Texas Water Wells).

    Input schema
    {
  "type": "object",
  "properties": {
    "county": {
      "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
    },
    "aquifer": {
      "type": "string",
      "examples": [
        "Edwards"
      ]
    },
    "wellUse": {
      "type": "string"
    },
    "minDepthFt": {
      "type": "number"
    },
    "maxDepthFt": {
      "type": "number"
    },
    "limit": {
      "type": "number",
      "examples": [
        200
      ]
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    },
    "includeOwner": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

  • getGwdbSiteById

    read

    Fetch one GWDB site by state well number (e.g. "57-46-302").

    Required paramsstateWellNumber
    Input schema
    {
  "type": "object",
  "properties": {
    "stateWellNumber": {
      "type": "string",
      "examples": [
        "57-46-302"
      ]
    },
    "includeOwner": {
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "required": [
    "stateWellNumber"
  ]
}

  • searchBrackishWells

    read

    BRACS brackish-water wells. hasGeophysicalLog filters where SourceWellData mentions logs.

    Input schema
    {
  "type": "object",
  "properties": {
    "county": {
      "type": "string",
      "examples": [
        "Winkler"
      ]
    },
    "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
    },
    "hasGeophysicalLog": {
      "type": "boolean",
      "examples": [
        true
      ]
    },
    "hasLithology": {
      "type": "boolean"
    },
    "limit": {
      "type": "number"
    },
    "format": {
      "oneOf": [
        {
          "type": "string",
          "enum": [
            "records"
          ]
        },
        {
          "type": "string",
          "enum": [
            "geojson"
          ]
        }
      ]
    },
    "includeOwner": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

    hasLithology field does not exist on BRACS layer and is ignored.

  • getMajorAquifers

    read

    Texas 9 major freshwater aquifer extent polygons (Ogallala, Edwards, Gulf Coast…) as GeoJSON.

    Input schema
    {
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "examples": [
        "Ogallala"
      ]
    },
    "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"
    }
  },
  "additionalProperties": false
}

    Filter by name; supports bbox. Use with patchops_addMapLayer.

  • getMinorAquifers

    read

    Texas minor aquifer extent polygons (21 minor aquifers) as GeoJSON. Filter by name; supports bbox.

    Input schema
    {
  "type": "object",
  "properties": {
    "name": {
      "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"
    }
  },
  "additionalProperties": false
}

  • getServiceInfo

    read

    Schema, fields, and record counts. Pass layer to scope to one of sdr|plugging|gwdb|bracs.

    Input schema
    {
  "type": "object",
  "properties": {
    "layer": {
      "type": "string",
      "examples": [
        "sdr"
      ]
    }
  },
  "additionalProperties": false
}