Per-Water-System Supply and Demand, Jan2023 onwards
Per-water-system data from the Clearinghouse for urban retail water suppliers, from January 2023 onwards. One row per water system per reporting period.
Column header names have been reformatted to eliminate spaces and special characters.
Data dictionary
Field definitions supplied by the publishing agency in CKAN.
| Column | Type | Label | Description |
|---|---|---|---|
| ORG_ID | numeric | ORG_ID | — |
| SUPPLIER_NAME | text | SUPPLIER_NAME | — |
| WATER_SYSTEM_ID | text | WATER_SYSTEM_ID | — |
| REPORT_PERIOD_START_DATE | date | REPORT_PERIOD_START_DATE | — |
| REPORT_PERIOD_END_DATE | date | REPORT_PERIOD_END_DATE | — |
| POP_REPORT_PERIOD | numeric | POP_REPORT_PERIOD | — |
| DWR_STANDARD_LEVEL | text | DWR_STANDARD_LEVEL | — |
| POTABLE_SUPPLY_UOM | text | POTABLE_SUPPLY_UOM | — |
| POTABLE_SUPPLY_OU | numeric | POTABLE_SUPPLY_OU | — |
| POTABLE_SUPPLY_GAL | numeric | POTABLE_SUPPLY_GAL | — |
| POTABLE_SUPPLY_PRELIM_EST | text | POTABLE_SUPPLY_PRELIM_EST | — |
| POTABLE_DEMAND_UOM | text | POTABLE_DEMAND_UOM | — |
| POTABLE_VOL_SOLD_OU | numeric | POTABLE_VOL_SOLD_OU | — |
| POTABLE_VOL_SOLD_GAL | numeric | POTABLE_VOL_SOLD_GAL | — |
| POTABLE_SUPPLY_MINUS_SOLD_GAL | numeric | POTABLE_SUPPLY_MINUS_SOLD_GAL | — |
| POTABLE_DEMAND_RES_SF_OU | numeric | POTABLE_DEMAND_RES_SF_OU | — |
| POTABLE_DEMAND_RES_MF_OU | numeric | POTABLE_DEMAND_RES_MF_OU | — |
| POTABLE_DEMAND_RES_OU | numeric | POTABLE_DEMAND_RES_OU | — |
| POTABLE_DEMAND_RES_GAL | numeric | POTABLE_DEMAND_RES_GAL | — |
| R-GPCD | numeric | R-GPCD | — |
| POTABLE_DEMAND_RES_PRELIM_EST | text | POTABLE_DEMAND_RES_PRELIM_EST | — |
| POTABLE_DEMAND_AG_OU | numeric | POTABLE_DEMAND_AG_OU | — |
| POTABLE_DEMAND_AG_GAL | numeric | POTABLE_DEMAND_AG_GAL | — |
| POTABLE_DEMAND_CI_OU | numeric | POTABLE_DEMAND_CI_OU | — |
| POTABLE_DEMAND_I_OU | numeric | POTABLE_DEMAND_I_OU | — |
| POTABLE_DEMAND_CII_OU | numeric | POTABLE_DEMAND_CII_OU | — |
| POTABLE_DEMAND_CII_GAL | numeric | POTABLE_DEMAND_CII_GAL | — |
| POTABLE_DEMAND_IRR_OU | numeric | POTABLE_DEMAND_IRR_OU | — |
| POTABLE_DEMAND_IRR_GAL | numeric | POTABLE_DEMAND_IRR_GAL | — |
| POTABLE_DEMAND_O_OU | numeric | POTABLE_DEMAND_O_OU | — |
| POTABLE_DEMAND_O_GAL | numeric | POTABLE_DEMAND_O_GAL | — |
| POTABLE_DEMAND_PRELIM_EST | text | POTABLE_DEMAND_PRELIM_EST | — |
| NONPOTABLE_DEMAND_UOM | text | NONPOTABLE_DEMAND_UOM | — |
| RES_RECYCLED_DEMAND_OU | numeric | RES_RECYCLED_DEMAND_OU | — |
| RES_RECYCLED_DEMAND_GAL | numeric | RES_RECYCLED_DEMAND_GAL | — |
| RES_NONPOTABLE_DEMAND_OU | numeric | RES_NONPOTABLE_DEMAND_OU | — |
| RES_NONPOTABLE_DEMAND_GAL | numeric | RES_NONPOTABLE_DEMAND_GAL | — |
| RES_NONPOTABLE_DEMAND_IRR_OU | numeric | RES_NONPOTABLE_DEMAND_IRR_OU | — |
| RES_NONPOTABLE_DEMAND_IRR_GAL | numeric | RES_NONPOTABLE_DEMAND_IRR_GAL | — |
| NON_RES_RECYCLED_DEMAND_OU | numeric | NON_RES_RECYCLED_DEMAND_OU | — |
| NON_RES_RECYCLED_DEMAND_GAL | numeric | NON_RES_RECYCLED_DEMAND_GAL | — |
| NON_RES_NONPOTABLE_DEMAND_OU | numeric | NON_RES_NONPOTABLE_DEMAND_OU | — |
| NON_RES_NONPOTABLE_DEMAND_GAL | numeric | NON_RES_NONPOTABLE_DEMAND_GAL | — |
| NON_RES_NONPOTABLE_DEMAND_IRR_OU | numeric | NON_RES_NONPOTABLE_DEMAND_IRR_OU | — |
| NON_RES_NONPOTABLE_DEMAND_IRR_GAL | numeric | NON_RES_NONPOTABLE_DEMAND_IRR_GAL | — |
| NON_POTABLE_DEMAND_PRELIM_EST | text | NON_POTABLE_DEMAND_PRELIM_EST | — |
| POTABLE_SUPPLY_COMMENTS | text | POTABLE_SUPPLY_COMMENTS | — |
| POTABLE_DEMAND_COMMENTS | text | POTABLE_DEMAND_COMMENTS | — |
| NON_POTABLE_DEMAND_COMMENTS | text | NON_POTABLE_DEMAND_COMMENTS | — |
Resource details
| Format | CSV |
|---|---|
| Size | 8.5 MB |
| Rows | 22,160 |
| Last updated | Sep 27, 2026 |
| Part of | Urban Retail Water Supplier - Water Conservation, Supply, and Demand (June 2014 onwards) |
CKAN Data API
Access resource data through the CKAN DataStore API. The examples below use this resource's ID.
Endpoints
The Data API provides these actions. Creating or updating records requires appropriate permissions; the query actions read public DataStore records.
| Create | https://ckan.cdt.dev.datopian.com/api/3/action/datastore_create |
|---|---|
| Update / insert | https://ckan.cdt.dev.datopian.com/api/3/action/datastore_upsert |
| Query | https://ckan.cdt.dev.datopian.com/api/3/action/datastore_search |
| Query via SQL | https://ckan.cdt.dev.datopian.com/api/3/action/datastore_search_sql |
Query examples
"https://ckan.cdt.dev.datopian.com/api/3/action/datastore_search?resource_id=264c7888-f7eb-42b4-9a19-ceb162f3ae8a&limit=5""https://ckan.cdt.dev.datopian.com/api/3/action/datastore_search?resource_id=264c7888-f7eb-42b4-9a19-ceb162f3ae8a&q=jones""https://ckan.cdt.dev.datopian.com/api/3/action/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22264c7888-f7eb-42b4-9a19-ceb162f3ae8a%22%20LIMIT%205"SQL queries depend on whether SQL search is enabled by the portal.
OData query
Use the resource's OData URL and its field names for paging, selecting columns, or filtering rows.
ODATA_RESOURCE_URL?$top=5
ODATA_RESOURCE_URL?$skip=5&$top=5
ODATA_RESOURCE_URL?$select=FIELD_NAME&$filter=FIELD_NAME eq 'VALUE'Replace ODATA_RESOURCE_URL, FIELD_NAME, and VALUE with the details for the selected resource. See the OData query options guide (opens in a new tab) for more examples.
Use the API in code
JavaScript (JSONP)
var data = { resource_id: '264c7888-f7eb-42b4-9a19-ceb162f3ae8a', limit: 5, q: 'jones' };
$.ajax({
url: 'https://ckan.cdt.dev.datopian.com/api/3/action/datastore_search',
data: data,
dataType: 'jsonp',
success: function (response) {
console.log(response.result.total, response.result.records);
}
});Python
import json
from urllib.request import urlopen
url = 'https://ckan.cdt.dev.datopian.com/api/3/action/datastore_search?resource_id=264c7888-f7eb-42b4-9a19-ceb162f3ae8a&limit=5'
with urlopen(url) as response:
result = json.load(response)['result']
print(result['total'], result['records'])For parameters and response fields, see the CKAN DataStore documentation (opens in a new tab).