NYC DASHBOARDLIVE
DashboardEconomyRevenueSpendingImpactWorkbench
NYC DASHBOARDLIVE
/Developers

API Documentation

Public JSON API for NYC fiscal and civic data. Free, no auth required.

Rate Limits

Our API proxies NYC Open Data (Socrata). Unauthenticated requests are throttled at 1,000 requests/hour per IP. For higher limits, register for a free Socrata app token. All responses include fromCache and fetchedAt fields.

Endpoints

GET/api/health

Health check — returns system status, environment, and Socrata API connectivity.

Cache: None
Response: { status, timestamp, env, socrata }
curl https://nycdashboard.com/api/health
GET/api/search?q={query}

Fuzzy search across agencies, boroughs, and community districts. Returns matching results ranked by relevance.

Parameters
qstringSearch query (min 2 characters)
Cache: None (client-side)
Response: SearchResult[]
curl "https://nycdashboard.com/api/search?q=police"
GET/api/revenue

Revenue data: tax categories, property tax breakdown, 20-year trends, federal & state aid, business taxes, fines, and non-tax revenue.

Cache: 3600s (1 hour)
Response: ApiResponse<RevenuePageData>
curl https://nycdashboard.com/api/revenue
GET/api/spending

Spending data: agency budgets, payroll summary, capital vs. operating, historical trends, top contracts, and overtime rankings.

Cache: 3600s (1 hour)
Response: ApiResponse<SpendingPageData>
curl https://nycdashboard.com/api/spending
GET/api/impact

Impact data: 311 complaints, crime trends, MMR agency performance, and education outcomes.

Cache: 1800s (30 min)
Response: ApiResponse<ImpactPageData>
curl https://nycdashboard.com/api/impact
GET/api/agency/{slug}

Agency detail: budget history, payroll by title, active contracts, capital projects, MMR performance, and 311 complaints for a specific agency.

Parameters
slugstringAgency slug (e.g., nypd, doe, fdny). See list below.
Cache: 3600s (1 hour)
Response: ApiResponse<AgencyPageData>
curl https://nycdashboard.com/api/agency/nypd
GET/api/borough/{name}

Borough detail: population, 311 complaints, crime breakdown, agency spending, and community districts for a specific borough.

Parameters
namestringBorough ID: manhattan, bronx, brooklyn, queens, staten-island
Cache: 3600s (1 hour)
Response: ApiResponse<BoroughPageData>
curl https://nycdashboard.com/api/borough/manhattan

Agency Slugs

doecunynypdfdnydochradhsacsdycddohmhhhcdotdepparksddcdsnyhpdnychaomblawdcasdoitt

Underlying Data Sources

All data originates from NYC Open Data (Socrata). You can query these datasets directly using the SODA API.

DatasetIDRows
NYC Expense Budgetmwzb-yiwb135K
NYC Citywide Payrollk397-673e5.1M
NYC Contractsqyyg-4tf5240K
NYC Capital Projectsfb86-vt7u400K
Tax Revenue Actualsj3uq-sh95358
Property Valuation8y4t-faws10.5M
Property Tax Rates7zb8-7bpk28
311 Service Requestserm2-nwe938M
NYPD Complaint Data (Historic)qgea-i56i8.9M
NYPD Complaint Data (YTD)5uac-w243350K
Mayor's Management Reportrbed-zzin2.5K
Math Test Results74kb-55u952K
Graduation Ratesmjm3-8dw812K
Parking & Camera Violationsnc67-uf8985M
EXPLORE:Revenue·Spending·Impact·NYPD·DOE·Manhattan·Brooklyn
DATA: NYC OPEN DATA · CHECKBOOK NYC · NYC COMPTROLLER · CENSUS ACS
NYC DASHBOARD · 2025