TerraFunded Water API
Give a latitude and a longitude in Texas. Get back, in one call, what the wells already drilled around that point say about water: how deep, how far down the water stands, how the county changed in 20 years, how many tested wells nearby were above the drinking-water limits, and what the county requires for a well, a septic system and power.
See it on a parcel page Try a live answer OpenAPI 3.1 Ask for a key
GET /api/v1/water?lat=33.0124&lon=-94.3655
{
"location": { "county": { "name": "Cass County" } },
"wells": {
"nearby": {
"wells": 17, "radius_miles": 2,
"depth_ft": { "p25": 285, "median": 468, "p75": 542 },
"static_water_level_ft": { "median": 188 }
}
},
"water_quality": {
"indicators": [
{ "id": "arsenic",
"nearby": { "wells_above_limit": 0, "wells_tested": 15, "radius_miles": 10 } },
{ "id": "nitrate",
"nearby": { "wells_above_limit": 0, "wells_tested": 15, "radius_miles": 10 } }
]
},
"county_rules": { "topics": { "water_well": { ... }, "septic": { ... } } }
}Part of a real answer for Linden, Texas (2026-11-20). The full answer is below.
What is behind it
Wells
Every water well report that drillers have filed with the Texas Water Development Board since 2001, cleaned and reloaded every night. The same data as the Texas Well Atlas.
Water quality
11,283 wells with an accepted lab test since 1992 for arsenic, nitrate, fluoride and dissolved solids, counted with the rules of the Texas Well Water Quality Atlas.
County rules
Well, septic, electricity, mobile home and agricultural valuation rules for all 254 counties, each with its official source and the date it was verified. The same data as the county rules map.
Every figure comes with its sample size, its dates and its source. The figures describe wells that exist. They are not a prediction for an undrilled tract, and the API never says that water at a place is safe or unsafe.
Quick start
Send your key in the Authorization header. All answers are JSON over HTTPS.
curl "https://terrafunded.com/api/v1/water?lat=33.0124&lon=-94.3655" \
-H "Authorization: Bearer YOUR_KEY"
In JavaScript:
const res = await fetch("https://terrafunded.com/api/v1/water?lat=33.0124&lon=-94.3655", {
headers: { Authorization: "Bearer " + process.env.TERRAFUNDED_KEY },
});
if (!res.ok) throw new Error((await res.json()).detail);
const water = await res.json();
console.log(water.wells.nearby.depth_ft.median, "ft, from", water.wells.nearby.wells, "home wells");
In Python:
import os, requests
r = requests.get(
"https://terrafunded.com/api/v1/water",
params={"lat": 33.0124, "lon": -94.3655},
headers={"Authorization": f"Bearer {os.environ['TERRAFUNDED_KEY']}"},
timeout=15,
)
r.raise_for_status()
water = r.json()
for ind in water["water_quality"]["indicators"]:
near = ind["nearby"]
print(ind["id"], near["wells_above_limit"], "of", near["wells_tested"], "tested wells within", near["radius_miles"], "miles")
Try it here
The sample points need no key. They return live data, the same answer a key gets for any point in Texas.
Pick a sample point and press Run to see a live answer.
Endpoints
| Path | What it returns | Key | |
|---|---|---|---|
| GET | /api/v1/water?lat=&lon= | Everything for one point: nearby home wells, the county's 20-year change, tested wells nearby above each limit, county rules. | Yes |
| POST | /api/v1/water/batch | The same for up to 20 points in one call. | Yes |
| GET | /api/v1/wells?lat=&lon= | Individual driller reports around a point, each with the state's report number and link. Records only. | Yes |
| GET | /api/v1/counties/{id} | One county by FIPS code, slug or name. | Yes |
| GET | /api/v1/counties | All 254 counties in one table. Add ?format=csv for a file. | Yes |
| GET | /api/v1/grid | Median home well depth for every 0.1 degree cell of Texas. Add ?format=csv for a file. | Yes |
| GET | /api/v1/widget?lat=&lon= | The short summary the embeddable widget draws. No individual reports. | Widget key |
| GET | /api/v1/report?lat=&lon= | The same answer as a three-page PDF to keep or print: a map and a table of the nearest driller reports, the lab tests, the county rules and how the analysis was made. | Widget key |
| GET | /api/v1/water/sample?place= | A live answer for a fixed point (linden, dripping-springs, lubbock, weatherford). | No |
| GET | /api/v1/status | Dataset dates, last nightly refresh, hash of the state file. | No |
| GET | /api/v1/openapi.json | The OpenAPI 3.1 description of all of the above. | No |
Base URL: https://terrafunded.com/api/v1. The key also works in an X-API-Key header. Parameters: include picks sections (wells, water_quality, county_rules); records sets how many individual well reports to list (0 to 60); lang=es returns the county rule answers and page links in Spanish. Coordinates are WGS 84 decimal degrees, rounded to 5 decimals.
The answer for a point
A real answer for Linden, Cass County, captured on 2026-11-20 and shortened here. The data dictionary explains every field.
{
"point": {
"lat": 33.0124,
"lon": -94.3655
},
"location": {
"state": "TX",
"county": {
"fips": "48067",
"name": "Cass County",
"slug": "cass-county"
},
"near_county_line": false
},
"wells": {
"data_as_of": "2026-11-18",
"nearby": {
"radius_miles": 2,
"wells": 17,
"reliability": "medium",
"depth_ft": {
"p25": 285,
"median": 468,
"p75": 542
},
"static_water_level_ft": {
"p25": 125,
"median": 188,
"p75": 243,
"wells": 12
},
"yield_gpm": {
"median": 15,
"wells": 12,
"share_measured_by_pump_test": 0.167
},
"nearest_reports": [
{
"state_report_id": 186968,
"state_report_url": "https://www3.twdb.texas.gov/apps/waterdatainteractive/GetReports.aspx?Num=186968&Type=SDR-Well",
"distance_miles": 0.86,
"lat": 33.00639,
"lon": -94.3525,
"use": "Domestic",
"year_completed": 2006,
"depth_ft": 468,
"static_water_level_ft": 220,
"yield_gpm": 22,
"yield_test_method": "Unknown",
"ground_elevation_ft": 378
},
"..."
]
},
"county": {
"wells": 378,
"depth_ft": {
"p10": 280,
"p25": 320,
"median": 370,
"p75": 460,
"p90": 527
},
"change_over_20_years": {
"depth": {
"early_median_ft": 380,
"late_median_ft": 360,
"early_wells": 270,
"late_wells": 216,
"change_ft": -20,
"change_pct": -5.3,
"change_95_interval_ft": [
-47,
-4
],
"result": "no_clear_change"
},
"static_water_level": "..."
}
},
"attribution": {
"text": "Well data: Texas Well Atlas by TerraFunded",
"url": "https://terrafunded.com/wells",
"html": "<a href=\"https://terrafunded.com/wells\">Well data: Texas Well Atlas by TerraFunded</a>"
}
},
"water_quality": {
"data_as_of": {
"texas_groundwater_database": "2026-11-13",
"water_quality_portal": "2026-11-15"
},
"indicators": [
{
"id": "arsenic",
"limit": {
"value": 10,
"unit": "µg/L",
"comparison": "above",
"basis": "Federal drinking-water standard for public water systems (EPA maximum contaminant level)"
},
"nearby": {
"wells_tested": 15,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
20.4
],
"radius_miles": 10,
"radius_rule": "first_radius_with_10_tested_wells",
"wells_undetermined": 0,
"median_test_year": 2010,
"oldest_test_year": 1993,
"newest_test_year": 2026,
"nearest_tested_well_miles": 0.15
},
"county": "...",
"texas": "..."
},
"... nitrate, fluoride, fluoride_secondary, tds"
]
},
"county_rules": {
"topics": {
"water_well": {
"status": "no_rule_found_at_this_level",
"answer": "No groundwater conservation district covers this county on the TCEQ map, so there is no district that requires a permit or registration for a household well.",
"verified": "2026-11-11",
"sources": [
{
"url": "https://gisweb.tceq.texas.gov/arcgis/rest/services/Public/GCDs/MapServer/0",
"title": "TCEQ, Groundwater Conservation Districts map",
"date": "2025-12-17"
}
]
},
"septic": "...",
"electricity": "...",
"mobile_home_rv": "...",
"ag_valuation": "..."
}
},
"attribution": {
"required": true,
"text": "Water data: TerraFunded",
"url": "https://terrafunded.com/wells",
"html": "<a href=\"https://terrafunded.com/wells\">Water data: TerraFunded</a>",
"terms": "https://terrafunded.com/developers/terms"
}
}
The full answer (12,551 bytes)
{
"api": {
"name": "TerraFunded Water API",
"version": "1.1.0"
},
"point": {
"lat": 33.0124,
"lon": -94.3655
},
"location": {
"state": "TX",
"county": {
"fips": "48067",
"name": "Cass County",
"slug": "cass-county"
},
"near_county_line": false
},
"wells": {
"data_as_of": "2026-11-18",
"last_checked": "2026-11-20T00:29:29.419557+00:00",
"nearby": {
"population": "Home (domestic) water wells with a reported depth, new wells and replacements",
"radius_miles": 2,
"radius_rule": "smallest of 2, 3, 5, 10 or 15 miles with at least 10 home wells",
"wells": 17,
"reliability": "medium",
"depth_ft": {
"p25": 285,
"median": 468,
"p75": 542
},
"static_water_level_ft": {
"p25": 125,
"median": 188,
"p75": 243,
"wells": 12
},
"yield_gpm": {
"median": 15,
"wells": 12,
"share_measured_by_pump_test": 0.167
},
"nearest_well_miles": 0.86,
"wells_completed_last_10_years": 8,
"oldest_completed": "2002-12-05",
"newest_completed": "2025-04-01",
"other_uses_in_radius": {
"Stock": 2,
"Irrigation": 2,
"Public Supply": 1
},
"nearest_reports": [
{
"state_report_id": 186968,
"state_report_url": "https://www3.twdb.texas.gov/apps/waterdatainteractive/GetReports.aspx?Num=186968&Type=SDR-Well",
"distance_miles": 0.86,
"lat": 33.00639,
"lon": -94.3525,
"use": "Domestic",
"year_completed": 2006,
"depth_ft": 468,
"static_water_level_ft": 220,
"yield_gpm": 22,
"yield_test_method": "Unknown",
"ground_elevation_ft": 378
},
{
"state_report_id": 228146,
"state_report_url": "https://www3.twdb.texas.gov/apps/waterdatainteractive/GetReports.aspx?Num=228146&Type=SDR-Well",
"distance_miles": 0.99,
"lat": 33.02361,
"lon": -94.35472,
"use": "Domestic",
"year_completed": 2010,
"depth_ft": 230,
"static_water_level_ft": 123,
"yield_gpm": 14,
"yield_test_method": "Estimated",
"ground_elevation_ft": 347
}
]
},
"county": {
"population": "Home (domestic) water wells with a reported depth",
"wells": 378,
"period": "wells completed in the last 10 years",
"confidence": "standard",
"depth_ft": {
"p10": 280,
"p25": 320,
"median": 370,
"p75": 460,
"p90": 527
},
"static_water_level_ft": {
"p25": 95,
"median": 132,
"p75": 166,
"wells": 338
},
"yield_gpm": {
"p25": 15,
"median": 18,
"p75": 34.5,
"wells": 290
},
"texas_median_depth_ft": 250,
"rank_deepest_of_ranked_counties": 79,
"aquifers": [
{
"name": "Carrizo-Wilcox",
"kind": "major",
"zone": "subsurface",
"share_of_county": 0.863
},
{
"name": "Carrizo-Wilcox",
"kind": "major",
"zone": "outcrop",
"share_of_county": 0.136
},
{
"name": "Queen City",
"kind": "minor",
"zone": null,
"share_of_county": 0.778
}
],
"change_over_20_years": {
"comparable": true,
"periods": {
"early": "2003-2007",
"late": "2021-2025"
},
"rule": "A change counts as deeper or shallower only when the 95% bootstrap interval of the difference in medians excludes zero and the change is at least 10%.",
"depth": {
"early_median_ft": 380,
"late_median_ft": 360,
"early_wells": 270,
"late_wells": 216,
"change_ft": -20,
"change_pct": -5.3,
"change_95_interval_ft": [
-47,
-4
],
"result": "no_clear_change"
},
"static_water_level": {
"early_median_ft": 128,
"late_median_ft": 134,
"early_wells": 268,
"late_wells": 194,
"change_ft": 6,
"change_95_interval_ft": [
-7,
18
],
"result": "no_clear_change"
}
}
},
"pages": {
"point": "https://terrafunded.com/wells?at=33.0124,-94.3655",
"county": "https://terrafunded.com/wells/cass-county",
"underground": "https://terrafunded.com/wells/underground?lat=33.0124&lon=-94.3655"
},
"dataset": "Texas Well Atlas",
"doi": "10.5281/zenodo.24126380",
"license": "CC BY 4.0",
"methodology": "https://terrafunded.com/wells/methodology",
"attribution": {
"text": "Well data: Texas Well Atlas by TerraFunded",
"url": "https://terrafunded.com/wells",
"html": "<a href=\"https://terrafunded.com/wells\">Well data: Texas Well Atlas by TerraFunded</a>"
},
"caveat": "Figures describe wells already drilled nearby, from driller reports filed with the state. They are not a promise about any property: groundwater can change over short distances and with drought. A licensed water well driller can say what to expect on a specific tract."
},
"water_quality": {
"data_as_of": {
"texas_groundwater_database": "2026-11-13",
"water_quality_portal": "2026-11-15"
},
"population": "Wells of any use with an accepted lab test since 1992; each well counts once, by its most recent accepted test",
"radius_rule": "first of 5, 10, 15 miles with at least 10 tested wells for that indicator; with fewer than 10 within 15 miles only the count is given",
"tested_wells_within_15_miles": 26,
"nearest_tested_well_miles": 0.15,
"indicators": [
{
"id": "arsenic",
"name": "Arsenic (dissolved)",
"limit": {
"value": 10,
"unit": "µg/L",
"comparison": "above",
"basis": "Federal drinking-water standard for public water systems (EPA maximum contaminant level)"
},
"nearby": {
"wells_tested": 15,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
20.4
],
"radius_miles": 10,
"radius_rule": "first_radius_with_10_tested_wells",
"wells_undetermined": 0,
"median_test_year": 2010,
"oldest_test_year": 1993,
"newest_test_year": 2026,
"nearest_tested_well_miles": 0.15
},
"county": {
"wells_tested": 34,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
10.2
],
"wells_undetermined": 0,
"median_test_year": 2002,
"domestic_share_of_tested_wells_pct": 53,
"sensitivity_range_pct": [
0,
0
]
},
"texas": {
"wells_tested": 10379,
"wells_above_limit": 742,
"share_above_limit_pct": 7.1,
"share_95_interval_pct": [
6.7,
7.7
],
"wells_undetermined": 43,
"median_test_year": 2005
}
},
{
"id": "nitrate",
"name": "Nitrate (as nitrogen)",
"limit": {
"value": 10,
"unit": "mg/L as N",
"comparison": "above",
"basis": "Federal drinking-water standard for public water systems (EPA maximum contaminant level)"
},
"nearby": {
"wells_tested": 15,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
20.4
],
"radius_miles": 10,
"radius_rule": "first_radius_with_10_tested_wells",
"wells_undetermined": 0,
"median_test_year": 2010,
"oldest_test_year": 1993,
"newest_test_year": 2026,
"nearest_tested_well_miles": 0.15
},
"county": {
"wells_tested": 34,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
10.2
],
"wells_undetermined": 0,
"median_test_year": 2002,
"domestic_share_of_tested_wells_pct": 53,
"sensitivity_range_pct": [
0,
0
]
},
"texas": {
"wells_tested": 11026,
"wells_above_limit": 697,
"share_above_limit_pct": 6.3,
"share_95_interval_pct": [
5.9,
6.8
],
"wells_undetermined": 16,
"median_test_year": 2004
}
},
{
"id": "fluoride",
"name": "Fluoride (dissolved)",
"limit": {
"value": 4,
"unit": "mg/L",
"comparison": "above",
"basis": "Federal drinking-water standard for public water systems (EPA maximum contaminant level)"
},
"nearby": {
"wells_tested": 15,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
20.4
],
"radius_miles": 10,
"radius_rule": "first_radius_with_10_tested_wells",
"wells_undetermined": 0,
"median_test_year": 2010,
"oldest_test_year": 1993,
"newest_test_year": 2026,
"nearest_tested_well_miles": 0.15
},
"county": {
"wells_tested": 34,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
10.2
],
"wells_undetermined": 0,
"median_test_year": 2002,
"domestic_share_of_tested_wells_pct": 53,
"sensitivity_range_pct": [
0,
0
]
},
"texas": {
"wells_tested": 10964,
"wells_above_limit": 427,
"share_above_limit_pct": 3.9,
"share_95_interval_pct": [
3.5,
4.3
],
"wells_undetermined": 5,
"median_test_year": 2004
}
},
{
"id": "fluoride_secondary",
"name": "Fluoride (dissolved), secondary level",
"limit": {
"value": 2,
"unit": "mg/L",
"comparison": "above",
"basis": "Federal secondary level (EPA secondary maximum contaminant level)"
},
"nearby": {
"wells_tested": 15,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
20.4
],
"radius_miles": 10,
"radius_rule": "first_radius_with_10_tested_wells",
"wells_undetermined": 0,
"median_test_year": 2010,
"oldest_test_year": 1993,
"newest_test_year": 2026,
"nearest_tested_well_miles": 0.15
},
"county": null,
"texas": {
"wells_tested": 10964,
"wells_above_limit": 2078,
"share_above_limit_pct": 19,
"share_95_interval_pct": [
18.2,
19.7
],
"wells_undetermined": 5,
"median_test_year": 2004
}
},
{
"id": "tds",
"name": "Total dissolved solids",
"limit": {
"value": 1000,
"unit": "mg/L",
"comparison": "above",
"basis": "Texas secondary level for public water systems"
},
"nearby": {
"wells_tested": 15,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
20.4
],
"radius_miles": 10,
"radius_rule": "first_radius_with_10_tested_wells",
"wells_undetermined": 0,
"median_test_year": 2010,
"oldest_test_year": 1993,
"newest_test_year": 2026,
"nearest_tested_well_miles": 0.15
},
"county": {
"wells_tested": 34,
"wells_above_limit": 0,
"share_above_limit_pct": 0,
"share_95_interval_pct": [
0,
10.2
],
"wells_undetermined": 0,
"median_test_year": 2002,
"domestic_share_of_tested_wells_pct": 53,
"sensitivity_range_pct": [
0,
2.5
]
},
"texas": {
"wells_tested": 10656,
"wells_above_limit": 2434,
"share_above_limit_pct": 22.8,
"share_95_interval_pct": [
22.1,
23.6
],
"wells_undetermined": 2,
"median_test_year": 2004
}
}
],
"pages": {
"atlas": "https://terrafunded.com/water-quality",
"county_table": "https://terrafunded.com/water-quality/counties#cass-county"
},
"dataset": "Texas Well Water Quality Atlas",
"doi": "10.5281/zenodo.24287393",
"license": "CC BY 4.0",
"methodology": "https://terrafunded.com/water-quality/methodology",
"study": "https://terrafunded.com/water-quality/study",
"attribution": {
"text": "Water quality data: Texas Well Water Quality Atlas by TerraFunded",
"url": "https://terrafunded.com/water-quality",
"html": "<a href=\"https://terrafunded.com/water-quality\">Water quality data: Texas Well Water Quality Atlas by TerraFunded</a>"
},
"caveat": "Counts are of wells that someone chose to test, using each well's most recent accepted lab test since 1992. They are not a sample of all wells and say nothing certain about the water of a particular well or an undrilled tract. The only way to know a well's water is to test it. The limits are standards for public water systems, used here as a yardstick; no law applies them to a private well."
},
"county_rules": {
"last_review": "2026-11-11",
"language": "en",
"topics": {
"water_well": {
"status": "no_rule_found_at_this_level",
"answer": "No groundwater conservation district covers this county on the TCEQ map, so there is no district that requires a permit or registration for a household well.",
"verified": "2026-11-11",
"sources": [
{
"url": "https://gisweb.tceq.texas.gov/arcgis/rest/services/Public/GCDs/MapServer/0",
"title": "TCEQ, Groundwater Conservation Districts map",
"date": "2025-12-17"
}
]
},
"septic": {
"status": "answered",
"answer": "Permit: Cass County (TCEQ authorized agent).",
"verified": "2026-11-11",
"sources": [
{
"url": "https://www.tceq.texas.gov/downloads/permitting/ossf/reporting-system/2025-aa-atcs.pdf",
"title": "TCEQ, OSSF authorized agents and permits issued in 2025",
"date": "2025"
}
]
},
"electricity": {
"status": "answered",
"answer": "Certificated service territory in the county: Bowie-Cass Electric Cooperative, Inc. (cooperative, ~90% of the county); Southwestern Electric Power Company (investor-owned utility, ~16% of the county); Upshur-Rural Electric Cooperative Corp. (cooperative, ~4% of the county). Some areas have more than one provider.",
"verified": "2026-11-11",
"sources": [
{
"url": "https://services6.arcgis.com/N6Lzvtb46cpxThhu/arcgis/rest/services",
"title": "PUC of Texas, certificated electric service areas (layers COOP_DIST, IOU, MUNI)",
"date": "2026-06"
}
]
},
"mobile_home_rv": {
"status": "not_reviewed",
"answer": null,
"verified": null,
"sources": []
},
"ag_valuation": {
"status": "answered",
"answer": "State rule, the same in every county. For land to be appraised by its agricultural use, it must have been devoted to agricultural or timber production for at least five of the past seven years. The application is Form 50-129, filed with the county appraisal district by April 30. We have not yet read this county's own appraisal district guide. Appraisal district website: https://www.casscad.org",
"verified": "2026-11-11",
"sources": [
{
"url": "https://comptroller.texas.gov/taxes/property-tax/ag-timber/index.php",
"title": null,
"date": "2026"
},
{
"url": "https://comptroller.texas.gov/taxes/property-tax/newsletter/vol36-apr26.php",
"title": null,
"date": "2026-04"
},
{
"url": "https://comptroller.texas.gov/taxes/property-tax/county-directory/cass.php",
"title": "Texas Comptroller, county appraisal district directory",
"date": "2026-11-10"
}
]
}
},
"dataset": "Texas county rules for rural land",
"license": "CC BY 4.0",
"page": "https://terrafunded.com/counties",
"attribution": {
"text": "County rules: TerraFunded",
"url": "https://terrafunded.com/counties",
"html": "<a href=\"https://terrafunded.com/counties\">County rules: TerraFunded</a>"
},
"caveat": "Summaries of county and district rules with their official sources and the date each was verified. Rules change: confirm with the office named in the source before acting. Not legal advice."
},
"attribution": {
"required": true,
"text": "Water data: TerraFunded",
"url": "https://terrafunded.com/wells",
"html": "<a href=\"https://terrafunded.com/wells\">Water data: TerraFunded</a>",
"terms": "https://terrafunded.com/developers/terms"
}
}How to read it
- wells.nearby: home wells with a reported depth inside the smallest radius of 2, 3, 5, 10 or 15 miles that holds at least 10 of them. Quartiles of total depth, of the depth to water when the well was finished, and the median yield. With fewer than 10 wells there is no typical figure, only the reports.
- wells.county.change_over_20_years: home wells completed in 2003 to 2007 against 2021 to 2025. A change counts only when the 95% bootstrap interval excludes zero and the change is at least 10%. For the water level, a positive change means the water stands lower.
- water_quality.indicators[].nearby: of the wells with an accepted lab test since 1992 inside the first radius of 5, 10, 15 miles that holds at least 10, how many had their most recent test above the limit. With fewer than 10 there is a count and no percentage. The county and statewide figures come along for context.
- county_rules.topics: a plain-language answer per topic with the official sources behind it and the date it was verified.
- location.near_county_line: true within about 0.15 miles of a county line. Then
other_countynames the neighbor, whose rules may be the ones that apply.
Why nearby wells
In the atlas's study, with rules and code fixed and dated before it ran, the tests from wells within 15 miles estimated a well's arsenic with 10.6% less error than the county figure (8,715 test wells) and 15.4% less than the USGS national model (the 7,904 of those wells that the model could not have seen). Knowing the aquifer added nothing once nearby tests were used. The API's count of nearby tested wells matches the study's own count exactly for 96.9% of 8,475 of those test wells and within one well for 99.9%; the rest sit on the edge of a radius, where the study measures on a projected map and the API on the sphere.
The widget: no code beyond one line
If you would rather not build the display yourself, put the widget on your parcel page. It is a frame served by TerraFunded that shows the wells, the lab tests and the county rules for the point you give it, with the credit already in place. It fits its own height and works on a phone.
- It takes a widget key (
tfp_live_...), which is public by design: it only opens/api/v1/widget, the short summary the widget draws, and/api/v1/report, the PDF, and never the JSON API. sections=wells,quality,ruleschooses the blocks to show.- Its PDF report button gives the visitor three pages for that point: the nearest well reports on a map, each linked to the state's record, the lab tests, the county rules and how the analysis was made.
label=prints your listing's name on it andreport=0hides the button. The same file is a plain link for your own button:/api/v1/report?lat=&lon=&key=. - Other sites may frame
/embed/water; search engines do not index it.
<iframe src="https://terrafunded.com/embed/water?lat=33.0124&lon=-94.3655&key=YOUR_WIDGET_KEY"
title="Water near this property" loading="lazy"
style="width:100%;border:0;height:640px"></iframe>
<script>
addEventListener("message", function (e) {
if (e.origin !== "https://terrafunded.com" || !e.data || e.data.type !== "terrafunded:water:height") return;
var f = document.querySelector('iframe[src*="/embed/water"]');
if (f) f.style.height = e.data.height + "px";
});
</script>Individual records and statewide files
Records, apart from summaries
/api/v1/wells returns driller reports one by one: the state's tracking number, the link to the official report, coordinates, use, year, depth, water level and yield. Nothing calculated is mixed into a record, except the distance to your point and a ground elevation read from terrain tiles, which is labeled as added. Owner, address and driller names are never loaded.
Water quality has no per-well endpoint. The API returns counts of tested wells, never one well's result. The underlying lab results are public in the state's Groundwater Database and the Water Quality Portal.
Whole-state files
/api/v1/counties?format=csv is one row per county: depth, water level, yield, 20-year change, and tested wells above each limit. /api/v1/grid?format=csv is the median depth of home wells in every 0.1 degree cell. Both are rebuilt when the nightly run publishes a new state file, so you can load them into your own system instead of calling per parcel.
The frozen, citable versions of the datasets are on Zenodo: wells 10.5281/zenodo.24126380, water quality 10.5281/zenodo.24287393. For a nightly feed of the full well table, write to us.
Errors, caching and versions
Errors are problem details (application/problem+json) with a stable code, a detail that says how to fix the call, and a request_id to quote if you write to us.
| HTTP | code | When |
|---|---|---|
| 401 | missing_key | Send your key in the Authorization header (Authorization: Bearer <key>) or in X-API-Key. |
| 401 | invalid_key | The key is not recognized, was revoked or has expired. |
| 400 | invalid_parameter | Invalid parameter |
| 400 | missing_parameter | Missing parameter |
| 422 | outside_texas | This API covers Texas only. The point is outside the state's counties. |
| 404 | not_found | Not found |
| 405 | method_not_allowed | Method not allowed |
| 413 | payload_too_large | Too many points |
| 503 | The well database did not answer. Try again in a few seconds. | |
| 500 | internal_error | Something failed on our side. If it keeps happening, write to us with the request_id. |
HTTP/1.1 422
Content-Type: application/problem+json
{
"type": "https://terrafunded.com/developers#error-outside-texas",
"title": "Point outside Texas",
"status": 422,
"code": "outside_texas",
"detail": "This API covers Texas only. The point is outside the state's counties.",
"request_id": "req_5f0c1e7a9b2d3c4e10",
"docs": "https://terrafunded.com/developers",
"point": {
"lat": 36.7,
"lon": -100
}
}
- Freshness. The well data changes once a night. Answers carry
X-Data-As-Of(the date of the state file) and can be reused for an hour (Cache-Control: private, max-age=3600)./api/v1/statusshows the last successful run. - Conditional requests. Every answer has an
ETag. Send it back inIf-None-Matchand you get304when nothing changed. - Fair use. Up to 5 calls per second and 50,000 per day per key. For more, use the statewide files or ask.
- Versions. This is version 1.2.0 (
X-API-Version). New fields can appear at any time, so ignore fields you do not know. A change that removes or renames a field gets a new path (/api/v2), and the old one keeps working for at least 90 days after we tell key holders. - CORS. Open to any origin, so a browser can call it. Keep keys out of public pages: call from your server.
Attribution
The data is free to use, also commercially, under CC BY 4.0. In exchange, wherever a figure from the API is shown to people, show the credit with a working link, in the same view as the figure. Each section of an answer carries its own line, ready to print:
| If you show | Credit line | HTML |
|---|---|---|
| Wells | Well data: Texas Well Atlas by TerraFunded | <a href="https://terrafunded.com/wells">Well data: Texas Well Atlas by TerraFunded</a> |
| Water quality | Water quality data: Texas Well Water Quality Atlas by TerraFunded | <a href="https://terrafunded.com/water-quality">Water quality data: Texas Well Water Quality Atlas by TerraFunded</a> |
| County rules | County rules: TerraFunded | <a href="https://terrafunded.com/counties">County rules: TerraFunded</a> |
| Several of them together | Water data: TerraFunded | <a href="https://terrafunded.com/wells">Water data: TerraFunded</a> |
Keep the meaning of the caveats that come with the data: figures of existing wells, not a promise about a property. The full conditions are in the terms.
Coverage and what comes next
Texas, all 254 counties. The county of a point comes from Census 1:500,000 boundaries. A parcel is answered by a point today, usually its centroid. If you need answers by polygon, another state, a nightly feed of the full well table or water quality by parcel in bulk, tell us: those are the next things we would build, and we would rather build them with someone who will use them.
Contact: Rodrigo Blanco, TerraFunded, [email protected]. API version 1.2.0, released 2026-11-20.
