SidewalkSnitch · How it works
From photo to ready-to-file complaint — how SidewalkSnitch works
Last updated: 2026-05-20
SidewalkSnitch handles the part of 311 that most people get wrong: figuring out which agency to file with, what violation code applies, and how to describe what you saw. Here is exactly what happens between "tap the camera" and a ready-to-file complaint sitting in your Filings view.
Photograph the violation
Open SidewalkSnitch on your phone and tap the yellow card on the home screen. Choose the violation category — Parking, Outdoor Dining, Sanitation, or Street Vending — then take a photo or upload one from your camera roll. The app reads the photo's EXIF GPS to suggest the location; you can tap the address field to correct it. Before the photo is stored, an EXIF stripper removes the GPS coordinates and camera metadata from the file itself.
AI classifies the violation
Tap Analyze. Your photo is sent to an AI vision model (xAI's Grok-4) along with a prompt containing NYC's rules registry for the category you selected. The model identifies which rule applies, extracts the license plate (for parking complaints), and drafts a plain-English complaint description — the kind of description a 311 operator would act on. This takes a few seconds. For parking violations, the app also queries NYC's Open Parking and Camera Violations dataset (dataset nc67-uf89) to show you any prior open violations on the plate. That history is shown on screen and is never stored on your complaint record.
You review and attest
The AI's draft description appears on a result card. Read it. If the model got something wrong — wrong plate, wrong violation type, a detail that doesn't match what you saw — edit it directly. When the description accurately reflects what you personally observed, check the attestation box: "I attest that this description is accurate to the best of my knowledge." The Submit button is not active until you check that box. Your complaint is your statement, not the AI's.
Your complaint is prepared for the right agency
SidewalkSnitch prepares your complaint for the city agency that handles the violation type: NYPD or NYC DOT for parking, NYC DOT for sidewalk-café violations, NYC DSNY for sanitation complaints, NYC DCWP for street vending. If you haven't verified your phone yet, the complaint is saved as a draft and the app prompts you to verify. Once you save it, it appears in your Filings view as "Saved — awaiting city submission." Direct submission to the city is not yet live, so there's no city Service Request Number or status update yet — if you want the city acting on it today, file the same details yourself at 311.nyc.gov or by calling 311.
What the AI does and does not do
The AI — xAI's Grok-4 vision model — does one thing: it reads your photo and produces a classification and a draft description. It does not auto-submit anything. It does not have access to your name, phone number, or address. It never sees the prior content of your other complaints.
The draft is a starting point. The model is trained on a benchmark set of NYC violation photos and is prompted with the NYC rules registry, but it makes mistakes. Misread plates, wrong violation types, details that don't match the photo — these happen. That is why the attestation step exists. You are the person who was there; you have the final say before anything goes to the city.
How agency routing works
Each violation type maps to a specific NYC agency. SidewalkSnitch handles this routing automatically:
- Parking violations — NYPD Traffic (most blocking violations) or NYC DOT (certain signing and crosswalk issues)
- Outdoor dining / sidewalk café violations — NYC DOT's sidewalk-café program (nyc.gov/dot)
- Sanitation violations — NYC Department of Sanitation (nyc.gov/dsny)
- Street vending — NYC Department of Consumer and Worker Protection via 311 (nyc.gov/dcwp)
What happens after you save a filing
Right now, SidewalkSnitch saves your complaint to your Filings and prepares it for the agency that handles that violation type. Direct submission to the city is not yet live: SidewalkSnitch does not currently transmit your complaint to 311 or generate a city Service Request Number, so there's no agency response to track yet. We'll update your filing automatically once city submission goes live.
If you want the city acting on this right now, you can file the same details yourself at 311.nyc.gov or by calling 311 — SidewalkSnitch doesn't stand in the way of that. Once a complaint is with 311, what the agency does with it is up to the agency: some result in a citation; many are closed as "officer investigated, no violation observed." That outcome depends on whether the vehicle or condition was still present when the responding officer arrived.
For time-sensitive violations — a car blocking a fire hydrant during an active emergency, for example — call 911 directly. SidewalkSnitch is not an emergency service.
See a violation right now?
Open SidewalkSnitch on your phone. The whole flow — photo to a ready-to-file complaint — takes under a minute.
Open the appWant more detail on a specific violation type? Guide: parking violations in NYC · Guide: fire hydrant blockers