The City Tracker Data model

Chris

29 Oct 2025 — 1 min read

City Tracker is an API-first company. In this post, we cover key technical features of our API.

Endpoints in production (status 10/29/2025):

tax_lots
permits

In progress:

filings
companies

These API endpoints are as consistent as possible: Each of them returns a list of results satisfying filter criteria with a standardized data model.

Key tags

Address: The closest representation of a building entrance. A building can have multiple addresses.
Tax lot: A plot of land that can be individually sold (or a condominium). A tax lot can have multiple addresses.
Zoning lot: A zoning lot consists of contiguous tax lots. These are not formally tracked in public data, and currently not tracked in City Tracker
BIN (Building Information Number): An identifier for a distinct building that's used in DOB filings and permits. A tax lot can have multiple BINs, a BIN can span multiple tax lots (rare), and a BIN can have different addresses.
Filing: A request to undertake work
Permit: Specific work tasks that result from an approved filing. A filing can result in multiple permits, each with a different work type.

City of Yes and Transit-Oriented Development: 23,000 lots got bigger

On December 5, 2024, the NYC city council passed the City of Yes (COY) rezoning plan, the largest zoning change in many decades, which aims to create 80,000 new units over the next decade. This rezoning changed so much that many ideas got completely lost in the press coverage.

Understanding our permit prediction

Our goal is to help you find good jobs that are about to come up. Essentially, this is a problem of prediction. And to do that well, we must first understand how the process works, especially for new construction. Here, we provide a non-technical overview of our approach, with technical

Understanding permits for new development

As part of our series to predict permitting, we zoom in on new construction. A crucial part of predicting is to understand the DOB permitting process: It starts with a filing. If approved, a single filing allows pulling possibly many permits, each with their own issuance and expiration date. For

There's one key metric predicting NYC development

We know where new residential development is happening. But it turns out that this, usually, isn't what you want to know. What you really need is to know where new development will happen. Otherwise, you're just chasing the past. At CityTracker, we've developed a

Key tags

Read more

City of Yes and Transit-Oriented Development: 23,000 lots got bigger

Understanding our permit prediction

Understanding permits for new development

There's one key metric predicting NYC development