@urbankitstudio/atlas 0.6.13 → 0.6.15

package/README.md

@@ -67,7 +67,14 @@ import { findCounty, buildParcelLookupDeepLink } from "@urbankitstudio/atlas";
 
 const kane = findCounty("illinois", "kane-county")!;
 const link = buildParcelLookupDeepLink(kane.endpoints[0]);
-// → https://urbankitstudio.com/tools/parcel-lookup?endpoint=https%3A%2F%2F...&fieldHint=TaxName
+// → https://urbankitstudio.com/tools/parcel-lookup?endpoint=https%3A%2F%2F...
+
+// Pass the county record as well and its primary layer (endpoints[0]), when
+// that layer refuses typed search or several counties share it, links to the
+// county's own page, which scopes it. Any other endpoint keeps the generic link:
+const alachua = findCounty("florida", "alachua-county")!;
+buildParcelLookupDeepLink(alachua.endpoints[0], undefined, alachua);
+// → https://urbankitstudio.com/tools/parcel-lookup/florida/alachua-county
 
 For single-address owner lookups in the browser, the free [Owner Lookup](https://urbankitstudio.com/tools/owner-lookup) tool reads the same county layers this package indexes.
 ```
@@ -81,7 +88,10 @@ For single-address owner lookups in the browser, the free [Owner Lookup](https:/
 | `findCounty(stateSlug, countySlug)` | `CountyRecord \| undefined` |
 | `findCountyByFips(fips)` | `CountyRecord \| undefined` — match by 5-digit county FIPS |
 | `listCountiesByState(stateSlug)` | `CountyRecord[]` |
-| `buildParcelLookupDeepLink(endpoint)` | URL string into the UrbanKit lookup tool |
+| `buildParcelLookupDeepLink(endpoint, base?, county?)` | URL string into the UrbanKit lookup tool; with `county`, the county route when the endpoint is that county's flagged or shared primary layer |
+| `canonicalLayerUrl(url)` | one key per layer: host + path, scheme, default port, query, fragment, a trailing `/query` and case folded away |
+| `offersAttributeSearch(endpoint)` | `false` when the layer refuses a `where` clause (`attributeSearch: "unsupported"`); query it by geometry instead |
+| `countyOffersAttributeSearch(county)` | `true` when any of the county's layers takes a `where` clause |
 | `slugify(s)`, `countySlugFromName(s)` | string helpers matching the atlas slug convention |
 | `statePath(slug)`, `countyPath(state, county)` | URL paths under `/parcel-atlas` |
 
@@ -134,9 +144,9 @@ Omit `?fips=` to get every tracked county in one call.
 
 ## Coverage today
 
-The atlas bundles **241 counties across all 50 US states and DC** (253 verified endpoints), covering the largest counties in each. Call `listStates()` to enumerate the full set.
+The atlas bundles **246 counties across all 50 US states and DC** (258 verified endpoints), covering the largest counties in each. Call `listStates()` to enumerate the full set.
 
-Every state has at least one county on record, and 235 of the 241 carry a verified endpoint. The other 6 have `hasPublicRest: false` and an empty `endpoints` array, with `notes` recording the reason and who to contact. Those reasons vary: a subscription-only regional GIS partner, a statewide server that requires an auth token, a state with no county-level parcel authority, a county viewer with no public query API, a county that does not publish owner names online. They ship rather than being omitted, so `findCounty()` still resolves them. **Check `hasPublicRest`** rather than assuming every county has an endpoint; `totals.countiesWithEndpoint` gives the queryable count directly.
+Every state has at least one county on record, and 240 of the 246 carry a verified endpoint. The other 6 have `hasPublicRest: false` and an empty `endpoints` array, with `notes` recording the reason and who to contact. Those reasons vary: a subscription-only regional GIS partner, a statewide server that requires an auth token, a state with no county-level parcel authority, a county viewer with no public query API, a county that does not publish owner names online. They ship rather than being omitted, so `findCounty()` still resolves them. **Check `hasPublicRest`** rather than assuming every county has an endpoint; `totals.countiesWithEndpoint` gives the queryable count directly.
 
 Counties are added as their public REST endpoints are verified. Package versions bump when data refreshes — pin to a minor range (`^0.x`) to receive new counties without breaking changes.
 

package/data/california.json

@@ -2,7 +2,7 @@
   "stateSlug": "california",
   "stateName": "California",
   "stateAbbrev": "CA",
-  "lastUpdated": "2026-09-26",
+  "lastUpdated": "2026-10-03",
   "counties": [
     {
       "id": "ca-los-angeles",
@@ -517,6 +517,113 @@
           }
         }
       }
+    },
+    {
+      "id": "ca-tulare",
+      "state": "CA",
+      "stateName": "California",
+      "stateSlug": "california",
+      "county": "Tulare",
+      "countySlug": "tulare-county",
+      "countyFips": "06107",
+      "ownerFieldNote": {
+        "body": "Tulare County's public parcel layer carries the APN, legal description, use code and acreage only: no owner name, no site address and no mailing address. Search by APN here. Ownership and addresses are held by the County Assessor. The City of Tulare's parcel layer at maps.tulare.ca.gov covers the city only and is not this county's layer.",
+        "source": {
+          "label": "Tulare County Assessor",
+          "url": "https://tularecounty.ca.gov/assessor/"
+        }
+      },
+      "capabilityOverrides": {
+        "owner_name": {
+          "status": "not_published",
+          "basis": {
+            "type": "endpoint_schema",
+            "note": "The county's public Parcels_(Public_View) layer carries APN, legal description, use code and acreage only; its field list has no owner-name column, and no other parcel service in the county's ArcGIS organisation carries one.",
+            "sourceUrl": "https://www.arcgis.com/home/item.html?id=8eb4a5d77ca64debbe9e391cd04cadf4"
+          }
+        },
+        "owner_mailing_address": {
+          "status": "not_published",
+          "basis": {
+            "type": "endpoint_schema",
+            "note": "The county's public Parcels_(Public_View) layer carries APN, legal description, use code and acreage only; its field list has no owner mailing-address column.",
+            "sourceUrl": "https://www.arcgis.com/home/item.html?id=8eb4a5d77ca64debbe9e391cd04cadf4"
+          }
+        },
+        "situs_address": {
+          "status": "not_published",
+          "basis": {
+            "type": "endpoint_schema",
+            "note": "The county's public Parcels_(Public_View) layer carries APN, legal description, use code and acreage only; its field list has no site-address column, so a parcel cannot be found by street address here.",
+            "sourceUrl": "https://www.arcgis.com/home/item.html?id=8eb4a5d77ca64debbe9e391cd04cadf4"
+          }
+        }
+      },
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://services2.arcgis.com/bYBANhmQGwSSLC0l/ArcGIS/rest/services/Parcels_(Public_View)/FeatureServer/0",
+          "serviceType": "FeatureServer",
+          "layerIndex": 0,
+          "layerName": "Current Parcels",
+          "supportsQuery": true,
+          "corsEnabled": true,
+          "searchFields": [
+            {
+              "name": "APN",
+              "label": "APN (9 digits, stored as text)",
+              "searchable": true
+            },
+            {
+              "name": "APNFormatted",
+              "label": "APN, formatted (000-000-000)",
+              "searchable": true
+            },
+            {
+              "name": "LegalDescription",
+              "label": "Legal Description",
+              "searchable": true
+            },
+            {
+              "name": "UseCodeDescription",
+              "label": "Use Code Description",
+              "searchable": false
+            },
+            {
+              "name": "UseCode",
+              "label": "Use Code",
+              "searchable": false
+            },
+            {
+              "name": "TaxRateArea",
+              "label": "Tax Rate Area",
+              "searchable": false
+            },
+            {
+              "name": "AcresAssessor",
+              "label": "Acres (Assessor)",
+              "searchable": false
+            },
+            {
+              "name": "AcresGIS",
+              "label": "Acres (GIS)",
+              "searchable": false
+            }
+          ],
+          "sampleQuery": "https://services2.arcgis.com/bYBANhmQGwSSLC0l/ArcGIS/rest/services/Parcels_(Public_View)/FeatureServer/0/query?where=APN%20LIKE%20%270090%25%27&outFields=APN,APNFormatted,LegalDescription,UseCodeDescription,AcresGIS&returnGeometry=false&resultRecordCount=10&f=json",
+          "license": "unknown",
+          "licenseUrl": "https://www.arcgis.com/home/item.html?id=8eb4a5d77ca64debbe9e391cd04cadf4",
+          "status": "live",
+          "lastVerified": "2026-10-03",
+          "verifiedBy": "manual"
+        }
+      ],
+      "contact": {
+        "department": "Tulare County Assessor, Cadastral Mapping and GIS",
+        "url": "https://tularecounty.ca.gov/assessor/",
+        "email": null
+      },
+      "notes": "Tulare County, California (county seat Visalia) publishes its parcels from the county GIS ArcGIS Online organisation as Parcels_(Public_View) FeatureServer layer 0 (Current Parcels): 166,875 rows on 2026-10-03. THE LAYER IS APN-ONLY. Its field list has no owner name, no site address and no mailing address, so this county answers an APN or legal-description search and nothing else. APN is a nine-digit TEXT value (e.g. 009040002), so compare it as a string: APN LIKE '0090%' or APN='009040002' works, and a numeric APN=1051002 comparison returns no rows. APNFormatted carries the dashed form (009-040-002). The layer also carries LegalDescription, TaxRateArea, UseCode, UseCodeDescription, ClassCode, CONTRACT and PRESERVE flags, SECTION, TOWNSHIP, AcresAssessor and AcresGIS. CORS is open (Access-Control-Allow-Origin: *) and maxRecordCount is 1000, half the usual page. The ArcGIS item states no licence. A richer sibling, Public_Parcels FeatureServer layer 0, adds land, improvement and personal-property values and the owner's postal state and ZIP only, still with no owner name and no street address; the org's Public_Parcel_Search, Regional Parcels and n01_Parcels services carry no owner either. Do not confuse this with maps.tulare.ca.gov, the CITY of Tulare: its Public_Parcels__Tulare_County layer covers only the city's urban growth boundary with no owner or address fields, and its housing-site layers carry owners for a few hand-picked city parcels. The assessor's web pages answer HTTP 403 to automated requests. Verified live 2026-10-03: APN LIKE '0090%' returned rows (first APN 009040002, 009-040-002, POR OF NW/4 5-15-28)."
     }
   ]
 }

package/data/index.json

@@ -3,9 +3,9 @@
   "lastUpdated": "2026-10-03",
   "totals": {
     "states": 51,
-    "counties": 241,
-    "endpoints": 253,
-    "countiesWithEndpoint": 235,
+    "counties": 246,
+    "endpoints": 258,
+    "countiesWithEndpoint": 240,
     "countiesUnprobeable": 1
   },
   "states": [
@@ -45,8 +45,8 @@
       "slug": "california",
       "name": "California",
       "abbrev": "CA",
-      "countyCount": 11,
-      "endpointCount": 11,
+      "countyCount": 12,
+      "endpointCount": 12,
       "populated": true
     },
     {
@@ -229,8 +229,8 @@
       "slug": "nebraska",
       "name": "Nebraska",
       "abbrev": "NE",
-      "countyCount": 3,
-      "endpointCount": 3,
+      "countyCount": 4,
+      "endpointCount": 4,
       "populated": true
     },
     {
@@ -253,8 +253,8 @@
       "slug": "new-jersey",
       "name": "New Jersey",
       "abbrev": "NJ",
-      "countyCount": 5,
-      "endpointCount": 5,
+      "countyCount": 6,
+      "endpointCount": 6,
       "populated": true
     },
     {
@@ -301,7 +301,7 @@
       "slug": "oklahoma",
       "name": "Oklahoma",
       "abbrev": "OK",
-      "countyCount": 1,
+      "countyCount": 2,
       "endpointCount": 1,
       "populated": true
     },
@@ -310,7 +310,7 @@
       "name": "Oregon",
       "abbrev": "OR",
       "countyCount": 7,
-      "endpointCount": 6,
+      "endpointCount": 7,
       "populated": true
     },
     {
@@ -349,8 +349,8 @@
       "slug": "tennessee",
       "name": "Tennessee",
       "abbrev": "TN",
-      "countyCount": 3,
-      "endpointCount": 3,
+      "countyCount": 4,
+      "endpointCount": 4,
       "populated": true
     },
     {

package/data/nebraska.json

@@ -2,7 +2,7 @@
   "stateSlug": "nebraska",
   "stateName": "Nebraska",
   "stateAbbrev": "NE",
-  "lastUpdated": "2026-05-15",
+  "lastUpdated": "2026-10-03",
   "counties": [
     {
       "id": "ne-douglas",
@@ -132,6 +132,116 @@
         "email": null
       },
       "notes": "Sarpy County NE (Omaha south/west suburbs, Bellevue, Papillion, La Vista, Gretna) hosts LandRecordsSearch/FeatureServer with 10 layers; layer 5 (Tax Parcels) is the polygon parcel layer with ownership data. Fields follow LGIM schema: PARCELID, OWNERNME1, OWNERNME2, CNVYNAME, PSTLADDRES, SITEADDRESS, CVTTXCD/CVTTXDSCRP, SCHLTXCD/SCHLDSCRP, USEDSCRP, NGHBRHDCD, CLASSCD, CLASSDSCRP, LNDVALUE, CNTASSDVAL, CNTTXBLVAL, RESFLRAREA, RESYRBLT. Query confirmed live: UPPER(OWNERNME1) LIKE '%SMITH%' returns real results (e.g., 'SMITH/SHAWN L' at '11106 S 18TH CIR BELLEVUE NE 68123'). The Cadastral/LandRecordsDynamic/MapServer provides the same parcels as a cached tile service. Sarpy County is the fastest-growing county in Nebraska. GIS portal at gis.sarpy.gov and open data at data2-sarpy.opendata.arcgis.com. The SIMS parcel viewer (maps.sarpy.gov/html5viewer/?Viewer=SIMS) is the public-facing tool."
+    },
+    {
+      "id": "ne-phelps",
+      "state": "NE",
+      "stateName": "Nebraska",
+      "stateSlug": "nebraska",
+      "county": "Phelps",
+      "countySlug": "phelps-county",
+      "countyFips": "31137",
+      "ownerFieldNote": {
+        "body": "Phelps County's parcels are published only through Nebraska's statewide parcel layer, which carries the parcel ID, situs address, legal description and assessed values but no owner name and no owner mailing address. Search by address or parcel ID here. Owner records are on the county assessor's gWorks property search.",
+        "source": {
+          "label": "Phelps County property search (gWorks)",
+          "url": "https://phelps.gworks.com/"
+        }
+      },
+      "capabilityOverrides": {
+        "owner_name": {
+          "status": "not_published",
+          "basis": {
+            "type": "endpoint_schema",
+            "note": "Nebraska's statewide StatewideParcelsExternal layer, the only public REST layer carrying Phelps County attributes, has no owner-name column in its field list. The county's gWorks vendor server exposes only a parcel key and acreage, and only to a browser.",
+            "sourceUrl": "https://www.nebraskamap.gov/"
+          }
+        },
+        "owner_mailing_address": {
+          "status": "not_published",
+          "basis": {
+            "type": "endpoint_schema",
+            "note": "Nebraska's statewide StatewideParcelsExternal layer, the only public REST layer carrying Phelps County attributes, has no owner mailing-address column in its field list. It carries the parcel ID, situs address, values and legal description only.",
+            "sourceUrl": "https://www.nebraskamap.gov/"
+          }
+        }
+      },
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://giscat.ne.gov/enterprise/rest/services/StatewideParcelsExternal/MapServer/0",
+          "serviceType": "MapServer",
+          "layerIndex": 0,
+          "layerName": "StatewideParcels",
+          "supportsQuery": true,
+          "corsEnabled": true,
+          "searchFields": [
+            {
+              "name": "Parcel_ID",
+              "label": "Parcel ID",
+              "searchable": true
+            },
+            {
+              "name": "State_PID",
+              "label": "State Parcel ID (county code + parcel ID)",
+              "searchable": true
+            },
+            {
+              "name": "Situs_Address",
+              "label": "Situs Address",
+              "searchable": true
+            },
+            {
+              "name": "Ph_City",
+              "label": "Situs City",
+              "searchable": false
+            },
+            {
+              "name": "Legal_Description",
+              "label": "Legal Description",
+              "searchable": true
+            },
+            {
+              "name": "Total_Assessed_Value",
+              "label": "Total Assessed Value",
+              "searchable": false
+            },
+            {
+              "name": "Land_Value",
+              "label": "Land Value",
+              "searchable": false
+            },
+            {
+              "name": "Improvements_Value",
+              "label": "Improvements Value",
+              "searchable": false
+            },
+            {
+              "name": "Classification_Code",
+              "label": "Property Classification Code",
+              "searchable": false
+            },
+            {
+              "name": "Acres_Deeded",
+              "label": "Deeded Acres",
+              "searchable": false
+            }
+          ],
+          "scopeWhere": "County_ID='137'",
+          "sampleQuery": "https://giscat.ne.gov/enterprise/rest/services/StatewideParcelsExternal/MapServer/0/query?where=County_ID%3D%27137%27%20AND%20Parcel_ID%3C%3E%27%27%20AND%20UPPER(Situs_Address)%20LIKE%20%27%25748%20RD%25%27&outFields=State_PID,Parcel_ID,Situs_Address,Ph_Full_Address,Total_Assessed_Value&returnGeometry=false&resultRecordCount=10&f=json",
+          "license": "unknown",
+          "licenseUrl": "https://www.nebraskamap.gov/",
+          "status": "live",
+          "lastVerified": "2026-10-03",
+          "verifiedBy": "manual"
+        }
+      ],
+      "contact": {
+        "department": "Phelps County Assessor (statewide layer compiled by the Nebraska Office of the CIO)",
+        "url": "https://phelps.gworks.com/",
+        "email": null
+      },
+      "notes": "Phelps County, Nebraska (county seat Holdrege) has no county-run public REST parcel layer with attributes. Its parcels are carried on Nebraska's statewide StatewideParcelsExternal MapServer layer 0 (StatewideParcels) at giscat.ne.gov, which the Office of the Chief Information Officer compiles from each county's CAMA and GIS data. Scope with County_ID='137' (the three-digit county code): 7,664 of the layer's 1,154,898 rows on 2026-10-03, of which 59 are polygons with blank attributes (Parcel_ID=''); add AND Parcel_ID<>'' to skip them, as the sample query does. THERE IS NO OWNER NAME AND NO OWNER MAILING ADDRESS in the layer's field list. Ownership_Type and Parcel_URL exist but were blank on the Phelps rows sampled, and Ownership_Type is deliberately not listed because the owner classifier would read it as an owner column. Searchable: Parcel_ID (e.g. 0000002.00), State_PID (county code plus parcel ID, e.g. 1370000002.00), Situs_Address (e.g. 10401 748 RD) and Legal_Description. Ph_Full_Address joins the situs with city and ZIP but was blank on most rows sampled. Assessed, land and improvement values, classification code, deeded acres, sale date and sale value are carried. CORS reflects the request Origin (Access-Control-Allow-Origin echoed back, credentials true) and maxRecordCount is 2000. The layer states no licence; its description says the data is compiled for official, internal use by the State of Nebraska. The county's own vendor server (mapserver01.gworks.com, Phelps_County_NE_Assessor) exposes only a parcel key and acreage and answers 403 without a browser referer, so it is not registered. The older TaxParcels2023 and HistoricalParcels services that search results list now return 404. Owner search is available only through the county's gWorks property search. Verified live 2026-10-03: County_ID='137' AND Parcel_ID<>'' returned rows (first Parcel_ID 0000002.00, 10401 748 RD, Overton)."
     }
   ]
 }

package/data/new-jersey.json

@@ -2,7 +2,7 @@
   "stateSlug": "new-jersey",
   "stateName": "New Jersey",
   "stateAbbrev": "NJ",
-  "lastUpdated": "2026-05-15",
+  "lastUpdated": "2026-10-03",
   "counties": [
     {
       "id": "nj-bergen",
@@ -107,7 +107,8 @@
           "licenseUrl": "https://www.njogis.com/",
           "status": "live",
           "lastVerified": "2026-05-15",
-          "verifiedBy": "manual"
+          "verifiedBy": "manual",
+          "scopeWhere": "COUNTY='BERGEN'"
         }
       ],
       "contact": {
@@ -571,6 +572,120 @@
           }
         }
       }
+    },
+    {
+      "id": "nj-essex",
+      "state": "NJ",
+      "stateName": "New Jersey",
+      "stateSlug": "new-jersey",
+      "county": "Essex",
+      "countySlug": "essex-county",
+      "ownerFieldNote": {
+        "body": "New Jersey's statewide parcel composite documents an OWNER_NAME column for Essex County, but it is not populated on the public web service: on 2026-10-03 none of the 178,089 Essex rows carried a value, so no query can retrieve ownership here. The NJ Office of GIS states in the service description that the OWNER_NAME field is redacted per Daniel's Law for public web access. PAMS parcel identifier, municipality, property location, the mailing address on the tax record, assessed values and sale price are populated and searchable. Ownership is available from the municipal tax assessor.",
+        "source": {
+          "label": "New Jersey Office of GIS, statewide MOD-IV parcel composite",
+          "url": "https://www.nj.gov/njgin/"
+        }
+      },
+      "capabilityOverrides": {
+        "owner_name": {
+          "status": "restricted",
+          "basis": {
+            "type": "county_cited_statute",
+            "note": "The statewide composite layer's OWNER_NAME column returns no value for any Essex County record, and the NJ Office of GIS states in the service description that the field is redacted per Daniel's Law for public web access.",
+            "citation": "N.J. Daniel's Law",
+            "attributedTo": "NJ Office of GIS (service description)",
+            "sourceUrl": "https://www.nj.gov/njgin/"
+          }
+        }
+      },
+      "countyFips": "34013",
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://services2.arcgis.com/XVOqAjTOJ5P6ngMu/arcgis/rest/services/Parcels_Composite_NJ_WM/FeatureServer/0",
+          "serviceType": "FeatureServer",
+          "layerIndex": 0,
+          "layerName": "Cad_parcel_mod4",
+          "supportsQuery": true,
+          "corsEnabled": true,
+          "searchFields": [
+            {
+              "name": "PAMS_PIN",
+              "label": "PAMS Parcel Identifier (MUN_BLOCK_LOT)",
+              "searchable": true
+            },
+            {
+              "name": "PROP_LOC",
+              "label": "Property Location / Address",
+              "searchable": true
+            },
+            {
+              "name": "MUN_NAME",
+              "label": "Municipality Name",
+              "searchable": true
+            },
+            {
+              "name": "ST_ADDRESS",
+              "label": "Mailing Street Address",
+              "searchable": true
+            },
+            {
+              "name": "CITY_STATE",
+              "label": "Mailing City and State",
+              "searchable": false
+            },
+            {
+              "name": "ZIP_CODE",
+              "label": "Mailing ZIP Code",
+              "searchable": false
+            },
+            {
+              "name": "PROP_CLASS",
+              "label": "Property Class Code",
+              "searchable": false
+            },
+            {
+              "name": "LAND_VAL",
+              "label": "Land Value",
+              "searchable": false
+            },
+            {
+              "name": "IMPRVT_VAL",
+              "label": "Improvement Value",
+              "searchable": false
+            },
+            {
+              "name": "NET_VALUE",
+              "label": "Net Assessed Value",
+              "searchable": false
+            },
+            {
+              "name": "CALC_ACRE",
+              "label": "Calculated Acreage",
+              "searchable": false
+            },
+            {
+              "name": "SALE_PRICE",
+              "label": "Last Sale Price",
+              "searchable": false
+            }
+          ],
+          "sampleQuery": "https://services2.arcgis.com/XVOqAjTOJ5P6ngMu/arcgis/rest/services/Parcels_Composite_NJ_WM/FeatureServer/0/query?where=COUNTY%3D%27ESSEX%27%20AND%20UPPER(PROP_LOC)%20LIKE%20%27%25BROAD%25%27&outFields=PAMS_PIN,MUN_NAME,PROP_LOC,ST_ADDRESS,CITY_STATE,ZIP_CODE,NET_VALUE&returnGeometry=false&resultRecordCount=10&f=json",
+          "license": "public",
+          "licenseUrl": "https://www.arcgis.com/home/item.html?id=533599bbfbaa4748bf39faf1375a8a9c",
+          "status": "live",
+          "lastVerified": "2026-10-03",
+          "verifiedBy": "manual",
+          "scopeWhere": "COUNTY='ESSEX'"
+        }
+      ],
+      "contact": {
+        "department": "NJ Office of GIS (NJOGIS), Statewide MOD-IV Composite",
+        "url": "https://www.nj.gov/njgin/",
+        "email": null
+      },
+      "notes": "Essex County, New Jersey (county seat Newark) is served from the NJ Office of GIS statewide Parcels and MOD-IV composite, Parcels_Composite_NJ_WM FeatureServer layer 0 (Cad_parcel_mod4), the same layer Bergen County uses. Filter with COUNTY='ESSEX': 178,089 of the layer's 3,481,240 rows on 2026-10-03. OWNER_NAME is an empty string on every row statewide: COUNTY='ESSEX' AND OWNER_NAME<>'' returns 0, while the control COUNTY='ESSEX' AND ST_ADDRESS<>'' returns all 178,089. Test it with <>'' because IS NOT NULL passes on the blank strings. The column is deliberately not listed as a search field, because the owner classifier takes the first owner-looking field and would route owner lookups to a blank column. The service description says the field is redacted per Daniel's Law for public web access. Searchable: PAMS_PIN (municipality code, block and lot, e.g. 0707_301_6), PROP_LOC (property location), MUN_NAME, and ST_ADDRESS, the mailing street on the tax record, with CITY_STATE and ZIP_CODE alongside. CITY_STATE is free text, so FAIRFIELD, NJ and FAIRFIELD,N.J. both occur. Property class, land, improvement and net values, acreage and the last sale come from MOD-IV. CORS is open (Access-Control-Allow-Origin: *), maxRecordCount is 2000 and the layer is Web Mercator. The item's licence text is a disclaimer that requests acknowledgement of NJOGIS and points to the State's conditions of use. Countywide shapefiles and the MOD-IV tax list are downloadable from NJGIN. Third-party Essex_County_Parcels copies on ArcGIS Online carry no owner column and are not registered. Verified live 2026-10-03: COUNTY='ESSEX' AND PROP_LOC LIKE '%BROAD%' returned rows (first PAMS_PIN 0707_301_6, 54 BROADWAY LANE, Fairfield Township)."
     }
   ]
 }

package/data/oklahoma.json

@@ -2,7 +2,7 @@
   "stateSlug": "oklahoma",
   "stateName": "Oklahoma",
   "stateAbbrev": "OK",
-  "lastUpdated": "2026-06-05",
+  "lastUpdated": "2026-10-03",
   "counties": [
     {
       "id": "ok-oklahoma",
@@ -44,6 +44,23 @@
         "email": null
       },
       "notes": "Oklahoma County is Oklahoma's most populous county (pop. 810,000; county seat Oklahoma City). The TaxParcelsPublics_view FeatureServer is hosted on ArcGIS Online (services8.arcgis.com, org ID euhkr1dAJeQBIjV0) and published via the OK County GIS Hub at ok-county-gis-hub-ok-co.hub.arcgis.com. Live query confirmed 336,922 parcels and owner-name exposure. Key fields: accountno (R-prefixed account number, e.g. 'R189878000'), name1/name2/name3 (up to three owners), mailingaddress1, city (mailing city), location (combined property address when populated, e.g. '17622 N INDIAN MERIDIAN RD OKLAHOMA CITY'), locationcity (property city), propertyid (numeric internal ID), taxdistrict, taxdistrictname, currentmarket, currentassessed, currenttaxable, landvalue, legal (legal description), subname, lot, block, section, township, range, acreage. Note: location and locationcity fields may be null for some rural parcels, when null, use legal/section/township/range for location. The former county ArcGIS Server at oklahomacounty.geocortex.com is no longer reachable (DNS fails as of 2026-06); the ArcGIS Online hosted view is the current canonical public layer. Oklahoma County Assessor portal at assessor.oklahomacounty.org provides the full record with appeals and valuation history."
+    },
+    {
+      "id": "ok-garfield",
+      "state": "OK",
+      "stateName": "Oklahoma",
+      "stateSlug": "oklahoma",
+      "county": "Garfield",
+      "countySlug": "garfield-county",
+      "countyFips": "40047",
+      "hasPublicRest": false,
+      "endpoints": [],
+      "contact": {
+        "department": "Garfield County Assessor",
+        "url": "https://www.assessor.garfieldok.com/",
+        "email": null
+      },
+      "notes": "No public REST parcel layer was found for Garfield County, Oklahoma (county seat Enid) as of 2026-10-03. The assessor's parcel viewer runs on Spatialest (property.spatialest.com/ok/garfield), whose map comes from a GeoServer at geo2.spatialest.com (workspace garfield-ok) that serves WMS images only: WFS is disabled, so there is no attribute or owner query. Oklahoma has no statewide parcel REST service. ArcGIS Hub and ArcGIS Online searches for Garfield County, Oklahoma parcels returned no items, while the same searches for Mahoning County parcels returned results, so the absence is meaningful. The one near miss is a 'Parcel Information' layer on ArcGIS Online (services1.arcgis.com/XDIvp05ZrOXRft7s) with owner, situs and parcel columns, but it covers only the Town of North Enid (540 parcels), not the county or the City of Enid, and is not registered. Results for 'Garfield County Land Explorer' belong to Garfield County, Colorado. Parcel and owner records are available through the assessor's Spatialest viewer."
     }
   ]
 }

package/data/oregon.json

@@ -242,14 +242,66 @@
       "county": "Clackamas",
       "countySlug": "clackamas-county",
       "countyFips": "41005",
-      "hasPublicRest": false,
-      "endpoints": [],
+      "ownerFieldNote": {
+        "body": "Clackamas County does not publish owner names or owner mailing addresses on any public layer. Its own taxlot layer carries the parcel number, map and taxlot number, site address and assessed values, so search by address or parcel number here. The county directs ownership questions to Assessment and Taxation (503-655-8671, propertytaxinfo@clackamas.us).",
+        "source": {
+          "label": "Clackamas County GIS",
+          "url": "https://www.clackamas.us/gis"
+        }
+      },
+      "capabilityOverrides": {
+        "owner_name": {
+          "status": "not_published",
+          "basis": {
+            "type": "endpoint_schema",
+            "note": "The county's public Taxlots_CMap layer has no owner-name column in its field list, and the county publishes no owner name on any public layer; it routes owner questions to Assessment and Taxation.",
+            "sourceUrl": "https://www.clackamas.us/gis"
+          }
+        },
+        "owner_mailing_address": {
+          "status": "not_published",
+          "basis": {
+            "type": "endpoint_schema",
+            "note": "The county's public Taxlots_CMap layer has no owner mailing-address column in its field list, and the county publishes no owner mailing address on any public layer; it routes owner questions to Assessment and Taxation.",
+            "sourceUrl": "https://www.clackamas.us/gis"
+          }
+        }
+      },
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://services3.arcgis.com/I2eWXOndpF9m8oKC/arcgis/rest/services/Taxlots_CMap/FeatureServer/0",
+          "serviceType": "FeatureServer",
+          "layerIndex": 0,
+          "layerName": "tax_taxlot_cmap",
+          "supportsQuery": true,
+          "corsEnabled": true,
+          "searchFields": [
+            { "name": "PARCEL_NUMBER", "label": "Parcel Number", "searchable": true },
+            { "name": "TLNO", "label": "Map and Taxlot Number", "searchable": true },
+            { "name": "SITUS", "label": "Situs Address", "searchable": true },
+            { "name": "SITUS_CITY", "label": "Situs City", "searchable": true },
+            { "name": "SITUS_ZIP", "label": "Situs ZIP", "searchable": false },
+            { "name": "TOTALVAL", "label": "Total Value", "searchable": false },
+            { "name": "ASSESSEDVAL", "label": "Assessed Value", "searchable": false },
+            { "name": "LANDCLASS", "label": "Land Class Code", "searchable": false },
+            { "name": "YEARBLT", "label": "Year Built", "searchable": false },
+            { "name": "SALE_PRICE", "label": "Last Sale Price", "searchable": false }
+          ],
+          "sampleQuery": "https://services3.arcgis.com/I2eWXOndpF9m8oKC/arcgis/rest/services/Taxlots_CMap/FeatureServer/0/query?where=UPPER(SITUS)%20LIKE%20%27%25MAIN%20ST%25%27&outFields=PARCEL_NUMBER,TLNO,SITUS,SITUS_CITY,TOTALVAL,LANDCLASS&returnGeometry=false&resultRecordCount=10&f=json",
+          "license": "unknown",
+          "licenseUrl": "https://www.arcgis.com/home/item.html?id=ba94373905a54b82b05946e164e38ec9",
+          "status": "live",
+          "lastVerified": "2026-10-03",
+          "verifiedBy": "manual"
+        }
+      ],
       "contact": {
         "department": "Clackamas County Department of Assessment and Taxation / Technology Services GIS",
         "url": "https://www.clackamas.us/gis",
         "email": "gisquestions@clackamas.us"
       },
-      "notes": "No public REST parcel layer with owner names was found for Clackamas County (county seat Oregon City) as of 2026-09-26. The county states that it does not publish property owner names online and directs owner-information requests to Assessment and Taxation, and its GIS shapefile downloads require accepting a data licensing agreement. No county-hosted ArcGIS REST catalog was found; the public tools, CMap and AscendWeb, are interactive viewers. Two statewide layers cover the county but neither can serve an owner search: the Oregon Department of Forestry's taxlot layer named 'Clackamas County' declares owner fields but has query disabled, and the Oregon Department of Transportation's taxlot layer is queryable but carries only map and taxlot numbers. Metro's regional RLIS 'Taxlots (Public)' dataset, per its listing, excludes ownership."
+      "notes": "Clackamas County, Oregon (county seat Oregon City) publishes its taxlots on ArcGIS Online as Taxlots_CMap FeatureServer layer 0 (tax_taxlot_cmap), from the county GIS organisation that feeds its CMap viewer: 163,927 taxlots on 2026-10-03. THERE IS NO OWNER NAME AND NO OWNER MAILING ADDRESS in the layer's field list. The county states that it does not publish property owner names online and directs owner questions to Assessment and Taxation. Searchable: PARCEL_NUMBER (8 digits, e.g. 01099411), TLNO (map and taxlot, e.g. 52E09CD01302), SITUS (site address) and SITUS_CITY, with SITUS_ZIP and SITUS_FULL alongside. The layer also carries assessed, land, building and total values, land class, year built, living area, bedrooms and bathrooms, and the last sale price and document. CORS is open (Access-Control-Allow-Origin: *) and maxRecordCount is 2000. The item's licence text is a disclaimer only (provided as is, not a land survey); the county's GIS shapefile downloads separately require accepting a data licensing agreement. A slimmer sibling service, Taxlots FeatureServer layer 0, carries only the parcel, taxlot and situs columns. Statewide layers add nothing for owner search: the Oregon Water Resources Department taxlot layer (Tax_Lots_Public_View_WGS84 MapServer layer 2, county_name='Clackamas') adds an owner mailing street with no owner name and is not registered here, the Oregon Department of Forestry's 'Clackamas County' taxlot layer declares owner fields but has query disabled, and Metro's regional RLIS 'Taxlots (Public)' dataset, per its listing, excludes ownership. Verified live 2026-10-03: UPPER(SITUS) LIKE '%MAIN ST%' returned rows (first PARCEL_NUMBER 01099411, 528 E MAIN ST, Molalla)."
     },
     {
       "id": "or-malheur",