How we pulled every grievance record in Nassau.
From Nov 5 to Nov 11, 2026, a plain Python script queried the county's public Land Records Viewer (LRV) once per parcel. It made 429,722 lookups in three passes and collected 6,460,852 appeal records going back to the 1988 roll. Separately, 156 official assessment-roll PDFs were downloaded and parsed for owner names and tentative and final assessed values. Then everything was joined on a normalized parcel ID. This page covers what was pulled, how, when, and by which agent, along with what's still unverified.
Methodology record · Public county data- Nassau Land Records Viewer, appeals endpoint:
https://lrv.nassaucountyny.gov/getappeals.php?id=<lrv_id> - Nassau GIS parcel layer
Parcels_2026_Clean:gis.nassaucountyny.gov/server/rest/services/Hosted/Parcels_2026_Clean/FeatureServer/0/query. This was the parcel universe, 407,648 features. - Nassau County Dept. of Assessment roll PDFs: the tentative and final roll index pages on
nassaucountyny.gov(5819, 5831, 5739, 5754, 5677, 5689, 5471, 5517, 5122, 5411, 5121, 5184). Each document's URL and SHA-256 is in roll_sources_sha256.csv.
FOIL was put on hold at Rae's direction and was not used. No paid data was used. Nothing was filed, posted or sent.
- Towns and cities: Hempstead, Oyster Bay, North Hempstead, Long Beach and Glen Cove, which together make up all of Nassau County.
- Final rolls: 2021/22 through 2026/27, 6 years.
- Tentative rolls: 2022/23 through 2027/28, 6 years. No 2021/22 tentative roll was posted on the archive pages.
- Appeal history (LRV): back to the 1988 roll year. Assessed values exist only for 2021/22 through 2027/28.
- Roll year mapping: LRV roll year Y = tax year (Y−1)/Y. LRV 2028 = the 2027/28 tentative roll, which has no final roll yet.
Methodology, step by step
Confirm the public endpoint
Xavier X Research tested the LRV appeals page live. It returns an HTML table per parcel with these columns: Roll Year, Appeal Type / Reason, Reference No, Status, Updated Assessment, Agent Name. There is no free countywide bulk download, so the plan was to make one request per parcel.
Build the parcel universe from GIS
pull_nassau_grievances.pypages theParcels_2026_Cleanfeature layer 2,000 records at a time (the layer's maxRecordCount). Fields kept: objectid, parid, parcelkey, address, class, LUC and school district. GIS reported 407,648 features. Condo units are not in this layer.Map each parcel ID to an LRV ID
Rule: replace the whitespace in the GIS
paridwith++. For example,01111 01390becomes01111++01390, and15 H 02510becomes15++H++02510. Condo units use different encodings, which were spot-checked live on Nov 10. For example,15-198- -0028-U-CA0111-00070becomes15198++0028UCA011100070, and lot-group units drop the++.Pilot, then the full run
The pilot did 30 parcels in about 30 seconds: 28 had appeal history and 23 showed Pending. The full run was launched with
--rate 2(0.5 s delay). The county server limited the actual pace to about 0.9–1 parcel per second. Each response is parsed into rows and written to a SQLite checkpoint, so the run survives restarts. Results export toparcel_status.csvandappeals_history.csv. Every request identifies itself with a research User-Agent. No model reads any parcel; it's a plain script.Condo-unit supplemental pull
The gap was found Nov 10. Unit IDs were taken from
pdftotext -layoutextracts of the 11 2026/27 final rolls. The official condo regex found 11,552 units, and a broader start-of-line pattern added 4,039 letter-block and lot-group units, for 15,591 units total, 0 conversion failures and 0 duplicate LRV IDs. This pull ran at 1 request/sec undernice 19, with its own checkpoint. A 20-minute pace watch was set to pause it if the main pull's speed dropped more than 30%.Roll-only and utility supplemental pull
6,483 IDs appeared on the rolls but in neither pull. Most were RS5 special-franchise and RS6 utility IDs (e.g.
1260004005), plus RS1/RS8 parcels missing from GIS. They were pulled at ≤1 request/sec,nice 19, using a restart-on-crash loop.Retry every error once
Errors were retried at ≤1 request/sec with the same endpoint and parser. Main pull: 202 errors resolved, ending at has 370,039 and none 37,021. Condo: 4 resolved (15,547 has, 44 none). Supplemental: 6 resolved (2,079 has, 4,404 none). Every network, timeout and parse error was cleared. The 588 GIS features with an empty
paridcan't be looked up.Download the assessment rolls
download_rolls.pydiscovered the current roll index pages, saved HTML snapshots, and downloaded every listed PDF serially at low priority (nice 15,ionice -c3, about 0.5 MiB/s cap). It validated each file as a real PDF and recorded its SHA-256 inmanifest.json. One file timed out (150/156) and was retried. Result: 156 of 156 validated, 0 failed.Parse the rolls
Each PDF was converted with
pdftotext -layout.- Tentative rolls: single-line tables, sliced on each page's header positions. Fields are PARID, OWNER1/2, IN_CARE_OF, owner address 1–3, property address, village, LUC, class, LAND_AV, TOTAL_AV and MARKET_VALUE. 0 parse failures.
- Final rolls (report AA315NY): multi-line blocks. Fields are SBL, owner, full market value, land and total AV, a transitional "T" amount, exemptions, taxable values, property address and Liber/Page.
- Reconciliation: parsed counts match each roll's own RECORD COUNT footer wherever it could be read. The 3 known one-record shortfalls and 793 flagged rows are listed in
qa_parse_flagged_rows.csv.
Normalize and join (no address matching)
parid_key= the ID in uppercase alphanumerics only. GIS01111 01390, tentative01111 01390, final01-111- -0139.0and LRV01111++01390all become0111101390.- Final-roll duplicates: final rolls list wholly-exempt parcels twice. Duplicates were collapsed, conflicts were flagged, and the result was 5,088,295 de-duplicated roll rows.
- Address joins: none were used.
- Owner names: the roll's owner of record, kept by year.
Validate
- Match rates: 99.87% of main GIS parcels (406,535 of 407,060) were found in a roll. 100% of condo units were. 99.73% of 2022–2028 appeals (2,121,458 of 2,127,115) matched a roll row in the same year.
- ARC updated assessment vs final AV: the two are equal for over 99.9% of ARC parcels each year. For 2027, 203,429 are equal and 61 differ.
- Hand check: condo unit
15-198--0028-U-CA0111-00070shows a 2026/27 final AV of 645 and an LRV 2027 ARC "Settled" of 645. - Rebuild comparison: the final build was compared against the 7:49 AM interim build.
Value definitions
- Tentative AV: TOTAL_AV on the tentative roll, the published baseline before the Assessment Review Commission (ARC) acts.
- Final AV: the full ("actual") AV on the final roll. For phased-in parcels, the printed total is the transitional value plus T.
- ARC updated assessment: the lowest numeric "Updated Assessment" on an ARC row for that year.
- Limits: a tentative-to-final drop is not assumed to be caused by an appeal or agent, and no tax savings are claimed.
Timeline
All times are Eastern (ET). Pull times come from each run's SQLite fetched_at column and log lines, roll times from project_state.json (converted from UTC), and conversation milestones from the agents' chat history. Where no exact time was logged, the entry says so.
From full/checkpoint.sqlite. Each parcel keeps only its latest fetch time, so the 202 parcels retried on Nov 11 are counted on Nov 11.
- Thu Nov 5 · before 12:24 PMRae → Xavier X Research
Rae asked: "I want to see can we verify which houses have a pending tax grievance and pull tax grievance history. Nassau county." He followed up with "How can we pull all records need a comprehensive solution" and "I want to use the dumb script runner to pull all parcels." Xavier confirmed the LRV endpoint live and counted about 408k GIS parcels. The exact time wasn't logged. The date comes from the pilot timestamps.
- Thu Nov 5 · 12:24:07–12:24:33 PMXavier X Research
The pilot ran 30 parcels: 28 had history and 23 showed Pending (
nassau-grievances/data/). - Thu Nov 5 · 12:24:49 PMXavier X Research → background worker
The full-county pull started with a GIS count of 407,648. Rae: "Hold off on the foil for now." The pull and its milestone pings were handed to a background worker, with a routine checking on it about every 3 hours. At about 1 parcel/sec, Xavier revised the estimate to about 5 days.
- Sat Nov 7 · 6:04 PMMonitor
181,090 of 407,648 processed (44.42%), with 164,883 having appeal history and 106 errors. The checkpoint today shows 180,959 parcels with a last fetch before that time.
- Sat Nov 7Rae → Xavier X Research
Rae authorized the whole assessment, ownership and appeal project (
PLAN.md), with FOIL still on hold and no outside uploads or contact. The main pull kept priority. - Sat Nov 7 · 9:46:33 PMXavier X Research
The roll-PDF downloader started on 12 county index pages (2021/22–2027/28).
- Sun Nov 8 · 12:03 AMXavier X Research
The one timed-out file, 2021/22 final Hempstead SD 21–25, was retried. All 156 PDFs were then validated: 3,201,706,905 bytes in 7,031 seconds.
- Mon Nov 9 · 9:03 AMMonitor
312,112 of 407,648 processed (76.6%), with 153 errors. The checkpoint shows 311,922.
- Mon Nov 9 · afternoon to evening (exact time not logged)Xavier X Research
A low-priority sample parse of the 2026/27 rolls for Glen Cove, Long Beach and North Hempstead matched 91.7% of parcels between tentative and final, and found 17,366 tentative-to-final reductions on parcels with tentative AV ≥ 1,000.
- Mon Nov 9 · 10:12 PMRae
Rae set a priority first cut: every Liberty Utilities / New York Water Service parcel, with AVs and grievances.
- Tue Nov 10 · 9:50 AMXavier X Research
The condo gap was found: condo units aren't in
Parcels_2026_Clean, but LRV accepts their unit IDs. - Tue Nov 10 · 4:44 PMXavier X Research → Cert Compiler
Status: 380,125 of 407,648 done (346,236 with appeals, 33,700 without, 189 errors). The checkpoint reached 380,125 at 4:46:57 PM.
- Tue Nov 10 · 7:39–7:40 PMXavier X Research
The main-pull pace baseline was captured at about 3,800 per hour, and the condo ID encodings were spot-checked live.
- Tue Nov 10 · 7:42:18 PMXavier X Research (Rae approved)
The condo pull started on 15,591 units, alongside the main pull.
- Wed Nov 11 · 1:43:33 AMXavier X Research
The main pull finished with 407,648 of 407,648 processed: 369,862 with history, 36,996 without, 790 errors (202 real errors plus 588 empty parid) and 5,741,517 appeal rows. The final run segment was 61,648 parcels in 1,539 minutes.
- Wed Nov 11 · 6:33:42 AMXavier X Research
The condo pull finished with 15,591 units in 651.4 minutes. Its 4 errors were retried by 6:58 AM.
- Wed Nov 11 · 6:58–7:03:51 AMXavier X Research
The main-pull retry resolved all 202 errors.
- Wed Nov 11 · 7:14:33 AMXavier X Research
The roll-only and utility pull started on 6,483 IDs.
- Wed Nov 11 · 1:43–7:49 AM (parse times not logged)Xavier X Research
All 156 rolls were parsed into 5,361,267 rows. The interim joined build finished at 7:49 AM.
- Wed Nov 11 · 11:10:33 AMXavier X Research
The roll-only pull finished: 5,992 IDs this run in 219.3 minutes. Its 6 errors were retried at 11:10:53–11:11:32 AM, ending at has 2,079 and none 4,404, with 34,527 appeal rows.
- Wed Nov 11 · 11:11 AM–11:24:34 AMXavier X Research
The final master rebuild started at 11:11:32. Exports followed at 11:17:25 (6,460,852 appeals, 2,982,850 parcel-years, 429,437 parcels). The methodology was written at 11:19, QA compared to the interim build at 11:19:45, and the lookup index finished at 11:23:32. Final build ready at 11:24:34 AM, local only and not published.
- Tue Nov 10 4:54 PM → Wed Nov 11 12:50 PMCert Compiler (downstream)
The preview grievance site repo was created at 4:54 PM Nov 10 and refreshed with aggregate stats from the completed main pull (7:05 AM Nov 11) and the final pull (merged at 12:50 PM Nov 11). These times are git commit times. This was a use of the data, not part of the pull.
The records
This is a representative random sample of 2,500 parcels, stratified by town in proportion to its parcel count (fixed seed 20261116), taken from the full joined table of 429,437 parcels. The full table is in nassau_records_full.csv.gz (16 MB gzip, 73 MB unzipped). Owner names come from the public assessment roll and are the owner of record, not necessarily the beneficial owner. No phone numbers, emails or mailing addresses are included.
Columns: SBL as printed on the 2027/28 tentative roll · property address · town · class · owner of record · tentative AV 2027/28 · tentative AV 2026/27 · final AV 2026/27 · lowest ARC updated assessment 2026/27 (LRV 2027) · LRV result (has/none) · 2027/28 grievance pending · appeals on file, all years. AV = assessed value. Market value ≈ AV ÷ level of assessment (0.1% class 1, 1% other classes).
Limits & known gaps
- 588 GIS features have an empty
paridand couldn't be looked up. 107 of them have a parcelkey that matches a roll parcel, and those parcels were covered by the roll-only pull. - Court outcomes: SCAR and certiorari (court) outcomes that come after the final roll aren't reflected in roll values, and LRV doesn't publish the reduction amount for court settlements.
- Utility parcels: the 2021/22 final roll is the only final roll that includes utility (RS5/RS6) values. For 2022/23–2026/27, utility parcels have tentative values only. No 2021/22 tentative roll was posted.
- Parse gaps: 3 records are missing from roll parsing (2022/23 Oyster Bay SD 17–3306 sections 1 and 8, and 2021/22 Hempstead section 6), and 793 rows are flagged. 525 grievance parcels and 25 latest-roll parcels didn't match.
- Snapshot in time: statuses are as of the fetch dates, Nov 5–11, 2026. Pending matters will change. The original methodology note says "Nov 9–11," but the checkpoints show main-pull fetches from Nov 5 on, so this page uses the checkpoint dates.
- Exact times: chat history has no timestamps. Rae's original request (Nov 5), the Nov 7 authorization, the Nov 9 sample parse and the Nov 11 roll parse have dates without exact times.
- File times: file modification times on disk are Nov 15, 12:39–12:46 AM ET for nearly everything, which reflects a later copy, not when work happened. They weren't used.
- Where it ran: the launch message said the runner would be copied to the P16. Later messages and all output files place the run on the Grok Bot box under
/workspace/nassau-grievances/. A copy of the script is also on the HP. - Owner names: these are the owner of record on the roll. No LLC members, phones or emails were added.
- Joins: joins use parcel IDs only. Tentative-to-final differences aren't attributed to any appeal or agent.