SidewalkSnitch · How it works

From photo to filed 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 "complaint acknowledged."

1

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 Idling — 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.

2

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.

3

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.

4

Your complaint goes to the right agency

SidewalkSnitch routes your complaint to 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 DEP via 311 for idling. If you haven't verified your phone yet, the complaint is saved as a draft and the app prompts you to verify. Once submitted, the complaint appears in your Filings view with a Service Request Number (SRN). Status updates — acknowledged, under review, resolved — flow back when the agency responds.

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)
  • Vehicle idling — NYC Department of Environmental Protection via 311 (nyc.gov/dep)

After you submit

When your complaint is submitted, it enters NYC's 311 queue for the relevant agency. The agency assigns a Service Request Number. SidewalkSnitch shows that SRN in your Filings view along with the complaint status. Status transitions — open, in progress, closed — reflect what the city reports back.

What the agency does with your complaint is up to the agency. SidewalkSnitch has no control over investigation decisions, citation issuance, or complaint closure. Some complaints 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 submitted complaint — takes under a minute.

Open the app

Want more detail on a specific violation type? Guide: parking violations in NYC · Guide: fire hydrant blockers

← Back to home