311

311 Citizen Service Request Classification — Scouting Report

Compiled 2026-08-28. Background research for building a 311 message classifier.

TL;DR — Ready-to-use models with weights?

No drop-in 311 classifier exists. There is no published Hugging Face model, no Kaggle checkpoint, and no GitHub release with weights specifically trained on 311 taxonomies. You need to fine-tune, or use an LLM zero/few-shot.

Option Weights? Fit
Any HF model tagged 311 / civic / service request ❌ none
CFPB consumer-complaint fine-tunes on HF (e.g. Dragneel/ticket-classification-v1 DistilBERT) Adjacent domain, usable as warm start
Generic ticket-routing HF models (trained on Tobi-Bueck/customer-support-tickets, IT-helpdesk) Even further from municipal, similar short-text routing shape
General base LMs — distilbert-base-uncased, roberta-base, deberta-v3-base, e5-large-v2, BGE-large, all-MiniLM-L6-v2 Realistic starting point: fine-tune or embed+kNN
Zero-shot LLMs (Claude, GPT-4o) ✅ (API) MDPI 2025 transport-complaint benchmark measured Claude ≈ 89.7%, GPT-4o ≈ 89.0%, GPT-3.5 ≈ 66.9% on a very similar civic-complaint task
Commercial “AI 311” CRMs (OpenGov, CivicPlus/SeeClickFix, Accela) ❌ closed Not usable as weights

Recommendation: two-track baseline — (1) Claude/GPT-4o zero-shot as the ceiling and (2) DistilBERT or DeBERTa-v3 fine-tuned on NYC 311 as the deployable model. For a warmer start than random init, initialize from a CFPB-complaint DistilBERT before fine-tuning on 311.


1. Public 311 Datasets

1.1 United States

City Portal / URL Volume Time coverage Notable text/label fields License
New York City data.cityofnewyork.us/Social-Services/311-Service-Requests-from-2020-to-Present/erm2-nwe9 plus 2010-2019 historical ~40M rows (as of Dec 2025) across the two datasets; ~32 columns 2010 → present, daily updates Complaint Type (~450 unique), Descriptor (~800 unique), Resolution Description (free text), Location Type, Agency, Agency Name NYC Open Data terms; effectively public / reuse permitted with attribution
Chicago data.cityofchicago.org/Service-Requests/311-Service-Requests/v6vf-nfxy. Companion Request Types dataset (dgc7-2pdf) Millions of rows; 91 published request types as of 2019, growing New 311 CRM launched 12/18/2018; some legacy pre-2018 records flagged LEGACY_RECORD SR_TYPE, SR_SHORT_CODE, OWNER_DEPARTMENT Open, City of Chicago terms
Boston data.boston.gov/dataset/311-service-requests (Analyze Boston); per-year resources (e.g. 2024, 2025). CRM Value Codex is a downloadable PDF at the same dataset page. ~250-300k/year (e.g. 273,951 rows in 2021); ~150 case types 2011 → present; backend system change Oct 2025 (some 2025 requests split between old/new tables) case_title, subject, reason, type, queue, department, neighborhood, source, closure_reason Open, City of Boston terms
San Francisco data.sfgov.org/City-Infrastructure/311-Cases/vw6y-z8j6 Several million; 191k views / 68k downloads 2008-07-01 → present, nightly Category, Request Type, Request Details, Responsible Agency, Media URL, Source (channel) Open, DataSF
Los Angeles (MyLA311) Per-year datasets on data.lacity.org — e.g. 2024, 2025, 2015 → 2025 ~1M/year Aug 2015 → present RequestType, RequestSource, CDNumber, AssignTo, Owner, Address Open, City of LA
Washington DC Per-year datasets on Open Data DC — e.g. 2025 and back to 2009 Millions across years 2009 → present, hourly refresh on “last 30 days” view SERVICECODEDESCRIPTION, SERVICETYPECODEDESCRIPTION, ORGANIZATIONACRONYM, INSPECTIONFLAG Open
Philadelphia (Philly311) opendataphilly.org/datasets/311-service-and-information-requests/; Carto-backed API Millions 2014-12-08 → present service_name, service_code, agency_responsible, description (short), requested_datetime Open
Seattle data.seattle.gov/City-Administration/Customer-Service-Requests/5ngg-rpne — the “Find It, Fix It” system Hundreds of thousands 2017 → present (some going back to 2013), quarterly refresh Request Type, Department, Neighborhood Open
Kansas City, MO 311 KCMO on data.kcmo.org 20M+ requests referenced in Kontokosta 2021 2007 → present CASE TYPE, WORK GROUP, DEPARTMENT, SOURCE Open
Syracuse, NY SeeClickFix-powered on city portal Smaller (city size) 2011 → present Request Type, Category Open

Many mid-size cities publish through SeeClickFix / Open311 endpoints (below).

1.2 International / Canada

1.3 Aggregators / cross-city

1.4 On Kaggle & Hugging Face


2. Taxonomies / Label Spaces

No standard. Each jurisdiction defines its own service_code/Complaint Type. Some observed shapes:

Common conceptual cluster (present in almost every city): Streets/Potholes/Sidewalks, Sanitation/Trash/Recycling, Noise, Graffiti, Illegal Parking, Trees/Parks, Streetlights, Rodents/Pests, Water/Sewer, Housing/Building Code, Homeless/Encampment, Animal Services, Abandoned Vehicle. That common core is roughly the space 311info uses.

Salient patterns:


3. Prior Academic Work

3.1 Directly on 311 text/type classification

3.2 Adjacent civic / grievance NLP

3.3 CFPB consumer complaint work (methodologically transferable)


4. Prior Industry / Government / Open-Source Work


Dataset Why relevant Size Access
CFPB Consumer Complaint Database Product/sub-product/issue text classification with a narrative; canonical benchmark for complaint NLP ~4M+ complaints (~13.8M+ if counting company responses) consumerfinance.gov/data-research/consumer-complaints/; public API
Customer Support Tickets (Tobi-Bueck/customer-support-tickets) Text→queue routing, EN+DE 61.8k HF
IT Helpdesk Synthetic Tickets (Console-AI) Balanced synthetic training set for ticket routing ~thousands HF
Kaggle “Customer Support Ticket Dataset” (suraj520) General ticket classification ~10k Kaggle
Seattle 911 CAD dispatch (data.seattle.gov) and other municipal CAD dumps 911-side of civic ML; short text + event type Millions Open
Reddit r/legaladvice / grievance corpora Long-tail informal complaint text Millions HF, Pushshift
FEMA Disaster reports, US National Highway ARF, USDA Complaint text Short-narrative government text Varies data.gov
20 Newsgroups, DBpedia, AG News Standard text-classification baselines for pretraining ablations Small HF/UCI
HiClassarxiv.org/pdf/2112.06560 scikit-learn-compatible hierarchical classifier library; useful if you exploit NYC Type→Descriptor hierarchy GitHub
BERTopic, contextualized topic models For unsupervised discovery when labels drift HF/GitHub

6. Key Challenges Documented in Prior Work

  1. Severe class imbalance. In NYC ~50%+ of requests route to NYPD (mostly noise + illegal parking). A “predict majority agency” baseline is already ~50%. Long tail of low-frequency complaint types under-fit (Hashemi 2022; multiple TDS blog posts; the Chinese customer-complaint text-enhancement paper).

  2. Taxonomy drift and inconsistency.
    • Cities re-organize categories periodically (Chicago’s 2018-12-18 CRM rewrite; NYC descriptors added/renamed; Boston’s Oct-2025 backend transition splitting the dataset).
    • Complaint Type / Descriptor co-occurrence is many-to-many; single free-text description often maps to multiple valid labels.
    • No cross-city standard (Open311 leaves service_code to the jurisdiction), so multi-city training requires an explicit label reconciliation step — cf. 311info’s LLM-assisted mapping and Hashemi 2022’s “standardize categories across two cities” step.
  3. Free-text ambiguity and short-text sparsity. Boston’s short titles and Philly’s description fields are often <15 tokens; customer descriptions may say “hole in street” (pothole? sinkhole? construction defect?). The MDPI 2025 LLM-vs-embedding paper found Claude ~89.7% but GPT-3.5 ~67% — model choice matters heavily on short civic text.

  4. Reporting/geographic bias (fairness). Kontokosta et al. 2017 and 2021, Wang & Kontokosta 2020, Agostini/Pierson/Garg AAAI 2024, Marron/AoAS 2025 — all document that low-English-proficiency, high-unemployment, non-white, and lower-income areas under-report. Training on raw counts therefore learns the bias. This affects downstream classification whenever priors depend on location.

  5. Missing-not-at-random outcome labels. Enforcement/inspection outcomes are systematically less recorded in historically underserved areas, so any supervised training on Resolution Description or SLA-met labels inherits that missingness.

  6. Multi-jurisdictional generalization. Same phrase (“blocked bike lane”) routes to different owning agencies in NYC, Chicago, LA. Fine-tuning per-city vs. one shared model is an open trade-off.

  7. Channel bias. Text quality varies drastically by intake channel — call-center dispatcher transcription vs. mobile-app self-report vs. Twitter/X vs. email. San Francisco survival-analysis work found Open311 vs. Twitter reports have different resolution-time distributions; the same is likely true for text style.

  8. Duplicates / near-duplicates. Same event reported many times; deduplication is a documented commercial-CRM feature (OpenGov, Accela).

  9. Multilingual and code-switching. Real intake includes Spanish, Chinese, Bengali, French (Montreal), Russian. Most public research has been English-only.

  10. Label-vocabulary evolution over time. A 10-year classifier must handle types that didn’t exist earlier (e.g. “e-scooter”, “encampment”), i.e. concept-drift.

  11. Aleatoric vs. epistemic uncertainty in tiny categories. ~800 NYC descriptors mean many have <100 training examples; hierarchical multi-label methods (see arXiv 2307.16265 survey; HiClass; Hierarchical MixUp arXiv 2209.13912) become relevant.

  12. Data-infrastructure critique. Cao 2021 (Cultural Studies) argues the 311 pipeline itself is not neutral — worth reading if the classifier is exposed to end users.

7. Suggested Starting Points for Building the Classifier

Given the above scout, the highest-leverage starting configuration is:


Sources (main URLs cited)

Datasets: NYC 2020-present, NYC 2010-2019, Chicago v6vf-nfxy, Chicago Request Types, Boston Analyze Boston, SF vw6y-z8j6, LA 2025, DC 2025, Philly, Seattle 5ngg-rpne, Toronto, FixMyStreet, 311info categories, Open311 GeoReport v2, SeeClickFix Open311 docs.

Papers: Hashemi 2022 (T&F), Kontokosta 2017 arXiv, Wang & Kontokosta 2017 PLOS One / arXiv 1611.06660, Agostini/Pierson/Garg 2024 AAAI arXiv 2312.11754, code repo, Liu et al. 2204.08620, GNN urban incident 2506.08740, MTAC 2603.11546, RL for NYC DOB 2605.06482, Xu Sustainable Cities 2020, Wang & Kontokosta 2020 Sustainable Cities, AoAS 2025 estimating reporting bias, Zero-shot LLM civic Nature Sci Rep 2025, MDPI Info 2025 transport LLM, BERTopic China gov PLOS 2024, Stacking-BERT China env complaints, CitySolution 2410.12882, Hierarchical multi-label survey 2307.16265, HiClass 2112.06560, SeeClickFix panel Schiff PAR 2025, Kontokosta 2021 Sust. Cities PDF.

CFPB: Consumer Complaint Database, arXiv 2606.22664, arXiv 2407.06399, arXiv 2310.06076.

Industry / gov: Boston ML routing StateScoop, Boston “Help us teach the new 311”, OpenGov 311, CivicPlus SeeClickFix, Harvard Data-Smart Cities 311 overview.