FlagHound API for developers.
FlagHound exposes a typed REST API over its NYC compliance pipeline. The same data that drives our dashboard and alerts is available programmatically. Free public lookups for any NYC building by BIN. Authed endpoints for enrolled customers via Clerk.
What you can do.
Base URL
https://reg-intel-production.up.railway.app
All responses are JSON. CORS is enabled for flaghound.com origins. Other origins use a static-token challenge for the public report endpoint.
OpenAPI spec
Machine-readable schema at /openapi.json. Drop it into Postman, Insomnia, or your favorite codegen tool. Interactive docs at /docs.
Public BIN report
GET /reports/{bin} returns ECB violations, DOB violations, DOB complaints, 311 complaints, permits, and OATH hearings for any NYC building. Turnstile-gated, no Clerk auth required.
Customer endpoints
Authed endpoints handle company onboarding, jobsite tracking, the Morning Brief feed, and alert delivery preferences. Bearer-token auth via Clerk. Get keys at hello@flaghound.com.
Data sources
NYC Open Data SODA endpoints (DOB NOW filings + permits, ECB and DOB violations, OATH hearings, 311 service requests, DOB complaints, Safety, HPD), the Federal Register, and NYC Geoclient for address-to-BIN resolution.
Rate limits
Public endpoints: 60 requests per minute per IP. Customer endpoints: no hard limit at current usage, monitored per company. Bulk imports and webhooks available on request.
Drop the spec into your tooling.
The OpenAPI document is the source of truth for every endpoint, every request, and every response. Generate typed clients in TypeScript, Python, Go, or whatever your stack speaks. Webhooks and bulk endpoints are on the roadmap and available today on request.