New York City Bylaws: City Datasets & API Access
Introduction
New York City, New York publishes hundreds of municipal datasets and APIs for public use. This guide explains how to find official datasets, request access, follow terms of use, and raise compliance or records requests in New York City. It focuses on official city sources, the agencies that manage data access, and practical steps for developers, researchers, and legal officers working with municipal data in New York City.
Overview: Where to Find City Data
The primary portal for municipal datasets and APIs is NYC Open Data, which hosts searchable datasets and API endpoints for departments across New York City. For policy, terms, and conditions governing use, consult the portal's official terms and support pages NYC Open Data Terms of Use[1]. Requests about platform operation and technical support are handled by the Department of Information Technology and Telecommunications (DoITT). For official DoITT contacts, see the agency contact page DoITT Contact[2].
Accessing APIs and Rate Limits
Many datasets include machine-readable API endpoints (Socrata-based endpoints or direct feeds). The portal documents how to call endpoints and common query parameters; specific rate limits, API keys, or programmatic restrictions are governed by the portal terms and platform documentation. If an API key, quota, or technical restriction is needed, submit a support request to DoITT or the dataset owner listed on the dataset page.
- Locate dataset page on NYC Open Data and check the API documentation and dataset owner.
- Contact DoITT for platform-level support or to report outages via the official DoITT contact page.[2]
- Review the dataset's metadata for update frequency, schema, and sample queries.
Data Licensing, Use, and Attribution
NYC Open Data describes permitted uses and attribution expectations in its portal documentation. For legal use in commercial products or redistribution, read the portal terms carefully; any specific licensing exceptions or commercial agreements should be confirmed with the dataset owner or DoITT. If a dataset lacks explicit licensing on its dataset page, contacting the agency owner is the recommended step.
Penalties & Enforcement
Enforcement for misuse of city datasets is primarily governed by the terms of use and the authority of the dataset owner and DoITT. Specific monetary penalties or statutory fines for misuse of public datasets are generally not listed on the portal terms page; when a fine or statutory penalty applies it will be specified on the controlling law or agency rule page. For content on record access and appeals, the Department of Records and FOIL procedures apply to requests for official records rather than API misuse.[1][3]
- Fine amounts: not specified on the cited page.
- Escalation: first, repeat, or continuing offences - not specified on the cited page.
- Non-monetary sanctions: access suspension, removal of accounts or API keys, and administrative orders may be applied by the platform or dataset owner.
- Enforcer: Department of Information Technology and Telecommunications (DoITT) and the dataset-owning agency; technical complaints routed to DoITT support.[2]
- Inspection and complaint pathway: file platform complaints with DoITT or submit records requests via the Department of Records FOIL portal.[2][3]
- Appeal/review routes and time limits: appeals for FOIL determinations follow Department of Records procedures; time limits for administrative appeals are set in FOIL guidance or by the agency response schedule—see the FOIL page for specifics.[3]
Applications & Forms
There is no general "API license" form published for NYC Open Data; most datasets are directly available on the portal without a special application. For official record requests or disputes, use the Department of Records FOIL request page and forms. FOIL Request[3]
How to Report Problems and Request Records
When data appears incorrect, incomplete, or a legal access issue arises, follow these actions:
- Contact the dataset owner listed on the dataset page and DoITT if the portal or API behaves incorrectly.[2]
- Submit a FOIL request through the Department of Records for official records or withheld information.[3]
- Escalate unresolved legal matters to the agency's legal unit or follow the FOIL appeal process.
FAQ
- Who runs NYC Open Data and who enforces its terms?
- The portal is managed with technical support from DoITT and datasets are owned and enforced by the publishing city agency.
- Do I need a permit or license to use API data?
- Most datasets are publicly accessible without a permit; check the dataset page for any special restrictions or contact the dataset owner.
- How do I request records that are not on the portal?
- File a FOIL request with the Department of Records following the instructions on their FOIL request page.[3]
How-To
- Find the dataset on NYC Open Data and open the dataset page to inspect metadata and API endpoints.
- Use the dataset's API endpoint or provided export tools; test queries in the portal's API console.
- If you encounter errors, contact the dataset owner and DoITT for technical support.[2]
- For missing or withheld official records, submit a FOIL request via the Department of Records.[3]
- If access is denied and you believe the denial is improper, follow the agency's appeal procedures or FOIL appeal guidance.
Key Takeaways
- NYC Open Data is the primary portal for municipal datasets and APIs.
- DoITT handles technical support; Department of Records manages FOIL and record appeals.
- Specific fines for misuse are not published on the portal terms page; follow agency guidance for disputes.
Help and Support / Resources
- NYC Open Data portal
- DoITT contact and support
- Department of Records FOIL requests
- Department of City Planning