{"contractVersion":"parcelops.connector.v1","name":"tx-puct","displayName":"PUCT Texas Water & Sewer Service Areas","description":"Texas retail water and sewer certificated service areas from the Public Utility Commission of Texas, read from the agency's own ArcGIS services. Answers which utility is obligated to serve a coordinate: 2,297 water CCN polygons, 967 sewer CCN polygons, and 477 certificated facility corridors, each carrying the certificate number, the utility of record, the counties it spans, and whether the boundary is contested in an open PUCT docket. A CCN obligates a retail public utility to serve every customer who requests service inside it. No certificated area at a point is not the same as no service: a Texas municipality may serve inside its own city limits without holding a CCN. Statewide Texas, WGS84, no credentials.","tags":["texas","puct","ccn","water","sewer","wastewater","utility","service-area","land","due-diligence","entitlement","rural"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"Public Utility Commission of Texas — Water and Sewer CCN Service Areas","sourceUrl":"https://www.puc.texas.gov/industry/water/utilities/gis/","apiBaseUrl":"https://services6.arcgis.com/N6Lzvtb46cpxThhu/arcgis/rest/services","documentationUrl":"https://www.puc.texas.gov/industry/water/utilities/map.aspx"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P3M","notes":"PUCT states the CCN spatial dataset is updated quarterly or as needed. CCN services last modified 2026-07-14 (observed 2026-08-10)."}},"coverage":{"geographic":{"status":"declared","value":["Texas (statewide)"]},"temporal":{"status":"declared","value":{"notes":"A snapshot of certificated areas as currently amended. It carries no history: a decertified or amended boundary is replaced, not versioned."}}},"methods":{"total":4,"items":[{"name":"queryCcnAtPoint","description":"Who provides water or sewer at a Texas coordinate: the certificated utility or water company.","notes":"Zero rows means no certificated provider of record, not that nobody serves it.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":25.5,"maximum":36.7,"description":"WGS84 latitude inside Texas."},"longitude":{"type":"number","minimum":-107,"maximum":-93.3,"description":"WGS84 longitude inside Texas (negative)."},"services":{"type":"array","description":"Which CCN layers to read. Defaults to both water and sewer.","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"type":"string","enum":["water","sewer"]}}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P3M","notes":"PUCT states the CCN spatial dataset is updated quarterly or as needed. CCN services last modified 2026-07-14 (observed 2026-08-10)."},"scope":"connector"},"entities":{"status":"declared","value":["utility_service_area"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["No CCN polygon at a point does not mean no water or sewer service. Texas Water Code 13.242 lets a municipality serve inside its own corporate limits without a CCN, which is why downtown Austin returns zero water and zero sewer CCN.","PUCT directs users to read service areas together with CCN facility lines: some utilities are certificated only along a corridor and hold no bounded service-area polygon.","A CCN is a service obligation of record, not confirmation that a main, tap, or capacity exists at the parcel. Confirm availability and extension policy with the named utility.","STATUS may read \"Pending Final Order Docket No. NNNNN\" and can name more than one docket, meaning the boundary is contested and subject to change.","CCN_NO can be comma-joined and COUNTY is a comma-joined label that PUCT truncates for wide certificates. Neither is a join key; use ccnNumbers[] and counties[].","One utility commonly holds several polygons under one CCN number. Union the rows before reporting a footprint.","PUCT electric service-area layers (IOU, cooperative, municipal) are NOT exposed by this connector because of a Platts Master Service Agreement restriction in their metadata, so it cannot say which electric utility or ISO/RTO serves a point. That is a deliberate license deferral, not an absence of PUCT electric data.","PUCT metadata is internally inconsistent: the water layer description is a copy of the sewer text and reports a 2015 update date against a 2026-07-14 modified date. Layer contents are correct; the upstream prose is never echoed.","TWDB and several city, county, and vendor tenants republish copies of these layers with different counts and no sewer coverage. This connector reads only PUCT's own organization; do not blend counts across mirrors.","Point-in-polygon at one coordinate. A parcel that straddles a boundary can have a different answer at its other corner."]},{"name":"searchCcnByUtility","description":"Find CCN service areas by utility name, certificate number, county, or docket status.","notes":"One utility often holds several polygons under one CCN number.","requiredParams":["service"],"inputSchema":{"type":"object","properties":{"service":{"type":"string","enum":["water","sewer"],"description":"Which CCN layer to search."},"utilityName":{"type":"string","maxLength":100,"description":"Case-insensitive fragment of the certificated name or trade name."},"ccnNumber":{"type":"string","pattern":"^[0-9A-Za-z]{4,12}$","description":"Certificate number. Matches rows whose CCN_NO is comma-joined."},"county":{"type":"string","maxLength":60,"description":"County name; matched inside the comma-joined COUNTY label."},"status":{"type":"string","enum":["approved","pending","any"],"description":"approved = Commission Approved; pending = awaiting a final order."},"limit":{"type":"integer","minimum":1,"maximum":500},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":["service"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P3M","notes":"PUCT states the CCN spatial dataset is updated quarterly or as needed. CCN services last modified 2026-07-14 (observed 2026-08-10)."},"scope":"connector"},"entities":{"status":"declared","value":["utility_service_area"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["No CCN polygon at a point does not mean no water or sewer service. Texas Water Code 13.242 lets a municipality serve inside its own corporate limits without a CCN, which is why downtown Austin returns zero water and zero sewer CCN.","PUCT directs users to read service areas together with CCN facility lines: some utilities are certificated only along a corridor and hold no bounded service-area polygon.","A CCN is a service obligation of record, not confirmation that a main, tap, or capacity exists at the parcel. Confirm availability and extension policy with the named utility.","STATUS may read \"Pending Final Order Docket No. NNNNN\" and can name more than one docket, meaning the boundary is contested and subject to change.","CCN_NO can be comma-joined and COUNTY is a comma-joined label that PUCT truncates for wide certificates. Neither is a join key; use ccnNumbers[] and counties[].","One utility commonly holds several polygons under one CCN number. Union the rows before reporting a footprint.","PUCT electric service-area layers (IOU, cooperative, municipal) are NOT exposed by this connector because of a Platts Master Service Agreement restriction in their metadata, so it cannot say which electric utility or ISO/RTO serves a point. That is a deliberate license deferral, not an absence of PUCT electric data.","PUCT metadata is internally inconsistent: the water layer description is a copy of the sewer text and reports a 2015 update date against a 2026-07-14 modified date. Layer contents are correct; the upstream prose is never echoed.","TWDB and several city, county, and vendor tenants republish copies of these layers with different counts and no sewer coverage. This connector reads only PUCT's own organization; do not blend counts across mirrors."]},{"name":"getCcnFacilityLinesNearPoint","description":"Certificated water or sewer facility corridors within a few miles of a Texas coordinate.","notes":"Only 477 corridors exist statewide, so a zero here is the common case.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":25.5,"maximum":36.7,"description":"WGS84 latitude inside Texas."},"longitude":{"type":"number","minimum":-107,"maximum":-93.3,"description":"WGS84 longitude inside Texas (negative)."},"radiusMiles":{"type":"number","minimum":0.1,"maximum":25,"description":"Search radius in statute miles. Defaults to 2."},"services":{"type":"array","description":"Which CCN layers to read. Defaults to both water and sewer.","minItems":1,"maxItems":2,"uniqueItems":true,"items":{"type":"string","enum":["water","sewer"]}},"limit":{"type":"integer","minimum":1,"maximum":200}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P3M","notes":"PUCT states the CCN spatial dataset is updated quarterly or as needed. CCN services last modified 2026-07-14 (observed 2026-08-10)."},"scope":"connector"},"entities":{"status":"declared","value":["utility_service_area"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["No CCN polygon at a point does not mean no water or sewer service. Texas Water Code 13.242 lets a municipality serve inside its own corporate limits without a CCN, which is why downtown Austin returns zero water and zero sewer CCN.","PUCT directs users to read service areas together with CCN facility lines: some utilities are certificated only along a corridor and hold no bounded service-area polygon.","A CCN is a service obligation of record, not confirmation that a main, tap, or capacity exists at the parcel. Confirm availability and extension policy with the named utility.","STATUS may read \"Pending Final Order Docket No. NNNNN\" and can name more than one docket, meaning the boundary is contested and subject to change.","CCN_NO can be comma-joined and COUNTY is a comma-joined label that PUCT truncates for wide certificates. Neither is a join key; use ccnNumbers[] and counties[].","One utility commonly holds several polygons under one CCN number. Union the rows before reporting a footprint.","PUCT electric service-area layers (IOU, cooperative, municipal) are NOT exposed by this connector because of a Platts Master Service Agreement restriction in their metadata, so it cannot say which electric utility or ISO/RTO serves a point. That is a deliberate license deferral, not an absence of PUCT electric data.","PUCT metadata is internally inconsistent: the water layer description is a copy of the sewer text and reports a 2015 update date against a 2026-07-14 modified date. Layer contents are correct; the upstream prose is never echoed.","TWDB and several city, county, and vendor tenants republish copies of these layers with different counts and no sewer coverage. This connector reads only PUCT's own organization; do not blend counts across mirrors.","A facility line is a certificated corridor, not a mapped pipe, and proximity is not a connection point."]},{"name":"getServiceInfo","description":"Layer inventory, live record counts, field vocabulary, docket links, and coverage limits.","notes":"Also names the electric layers this connector deliberately excludes.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P3M","notes":"PUCT states the CCN spatial dataset is updated quarterly or as needed. CCN services last modified 2026-07-14 (observed 2026-08-10)."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["No CCN polygon at a point does not mean no water or sewer service. Texas Water Code 13.242 lets a municipality serve inside its own corporate limits without a CCN, which is why downtown Austin returns zero water and zero sewer CCN.","PUCT directs users to read service areas together with CCN facility lines: some utilities are certificated only along a corridor and hold no bounded service-area polygon.","A CCN is a service obligation of record, not confirmation that a main, tap, or capacity exists at the parcel. Confirm availability and extension policy with the named utility.","STATUS may read \"Pending Final Order Docket No. NNNNN\" and can name more than one docket, meaning the boundary is contested and subject to change.","CCN_NO can be comma-joined and COUNTY is a comma-joined label that PUCT truncates for wide certificates. Neither is a join key; use ccnNumbers[] and counties[].","One utility commonly holds several polygons under one CCN number. Union the rows before reporting a footprint.","PUCT electric service-area layers (IOU, cooperative, municipal) are NOT exposed by this connector because of a Platts Master Service Agreement restriction in their metadata, so it cannot say which electric utility or ISO/RTO serves a point. That is a deliberate license deferral, not an absence of PUCT electric data.","PUCT metadata is internally inconsistent: the water layer description is a copy of the sewer text and reports a 2015 update date against a 2026-07-14 modified date. Layer contents are correct; the upstream prose is never echoed.","TWDB and several city, county, and vendor tenants republish copies of these layers with different counts and no sewer coverage. This connector reads only PUCT's own organization; do not blend counts across mirrors."]}]},"caveats":["No CCN polygon at a point does not mean no water or sewer service. Texas Water Code 13.242 lets a municipality serve inside its own corporate limits without a CCN, which is why downtown Austin returns zero water and zero sewer CCN.","PUCT directs users to read service areas together with CCN facility lines: some utilities are certificated only along a corridor and hold no bounded service-area polygon.","A CCN is a service obligation of record, not confirmation that a main, tap, or capacity exists at the parcel. Confirm availability and extension policy with the named utility.","STATUS may read \"Pending Final Order Docket No. NNNNN\" and can name more than one docket, meaning the boundary is contested and subject to change.","CCN_NO can be comma-joined and COUNTY is a comma-joined label that PUCT truncates for wide certificates. Neither is a join key; use ccnNumbers[] and counties[].","One utility commonly holds several polygons under one CCN number. Union the rows before reporting a footprint.","PUCT electric service-area layers (IOU, cooperative, municipal) are NOT exposed by this connector because of a Platts Master Service Agreement restriction in their metadata, so it cannot say which electric utility or ISO/RTO serves a point. That is a deliberate license deferral, not an absence of PUCT electric data.","PUCT metadata is internally inconsistent: the water layer description is a copy of the sewer text and reports a 2015 update date against a 2026-07-14 modified date. Layer contents are correct; the upstream prose is never echoed.","TWDB and several city, county, and vendor tenants republish copies of these layers with different counts and no sewer coverage. This connector reads only PUCT's own organization; do not blend counts across mirrors."]}