REGULATORY

SODA API (Socrata Open Data API)

Also known as: Socrata API, SODA, NYC Open Data API, SoQL

What is a SODA API (Socrata Open Data API)?

The SODA API (Socrata Open Data API) is the programmatic interface used to query NYC Open Data datasets, including the parking violation, OATH/ECB, and BIC violation databases. SODA enables automated systems to search for violations by license plate, date range, violation type, and other fields — returning structured JSON data that can be processed by fleet management software.

SODA uses a query language called SoQL (Socrata Query Language), which is similar to SQL. Common operations include filtering by plate number ($where=plate='ABC1234'), limiting results ($limit=1000), ordering by date ($order=issue_date DESC), and full-text searching within fields. The API is free to use but has rate limits — unauthenticated requests are throttled, while requests with an app token get higher limits.

For fleet compliance, SODA is the engine that powers automated violation monitoring. Instead of manually looking up each vehicle on CityPay, SODA queries can check an entire fleet in seconds. However, building reliable integrations requires handling edge cases like OATH's embedded plate numbers in free-text fields and varying data formats across datasets. Clear Plates uses optimized SODA queries — including batch lookups and charge-code filtering — to scan all three NYC violation datasets for your fleet automatically.

Key Facts

Query language: SoQL (Socrata Query Language)

Response format: JSON

Rate limits: Throttled without app token

Key datasets: DOF (nc67-uf89), OATH (jz4z-kudi), BIC (upii-frjc)

Track violations automatically

Clear Plates monitors every parking, camera, and idling violation across your fleet — so nothing slips through the cracks.

Get Started