geographicbuilding-permitschicagoconstruction-permitsmunicipal-dataconstructionpermit-dataestimated-costcleanedtaggedfreereal-estateopen-data

Chicago Building Permits

2000–2026

Free

Open dataset

Sample structure: 94.1 / 100
1 download links issued
Seller: Jannie Brits
Sign up to download

Already have an account? Log in

Agent? Connect your account →

Category
Geographic
Records
848,796 rows
Format
JSON
Update Frequency
Not documented
Collection Method
uploaded
PII
property_address
File Size
~0.01 MB
Download links issued
1

Source, license and coverage

Supplier documentation. These claims are separate from the automated sample score. A listing edit date is not a data freshness date.

License
Not documented — confirm reuse terms with the seller
Source / creator
Chicago Open Data — ydr8-5enu
Collection method
Supplier describes cleaning, deduplication and rule-based derived tags; see the listing description and per-record provenance fields.
Coverage / snapshot
2000–2026
Data last updated
Not documented
Update schedule
Not documented

Source documentation ↗

The supplier’s description contains reuse restrictions. Source portal access does not itself license every derived field or compilation; confirm the supplier’s terms before redistribution.

Sample structure score: 94.1 / 100

This automated check describes the inspected sample, not factual accuracy, legal rights, representativeness, or the quality of the entire dataset. It is not a customer rating.

Assessed 10 sample records (JSON) on 2026-10-09. All records in the provided sample were checked.

CheckPointsEvidence
Populated cells44.1 / 50247 of 280 top-level cells contain a value. Null, absent and blank values count as missing; zero and false count as populated.
Consistent value types30 / 30247 of 247 populated cells match their column's most common observed type. Types are inferred, not checked against real-world truth.
Consistent record shape20 / 2010 of 10 records have the expected fields. CSV/TSV use the header width; JSON uses the union of observed keys.
Field-level findings and improvements

Check missing cells and mixed types below. Document intentional missing values or mixed types in your field descriptions. Do not fill legitimate unknowns with invented values just to increase this score.

FieldMissing cellsMost common typeOther populated types
permit_id0 / 10number0 / 10
jurisdiction0 / 10string0 / 10
source_url0 / 10string0 / 10
status4 / 10string0 / 6
application_type0 / 10string0 / 10
date_lodged0 / 10string0 / 10
date_decided0 / 10string0 / 10
property_address0 / 10string0 / 10
suburb9 / 10number0 / 1
description0 / 10string0 / 10
estimated_cost0 / 10number0 / 10
value_category0 / 10string0 / 10
decoded_category0 / 10string0 / 10
decoded_confidence0 / 10number0 / 10
fetched_at0 / 10string0 / 10
license_note0 / 10string0 / 10
status_raw4 / 10string0 / 6
clean_version0 / 10number0 / 10
cleaned_at0 / 10string0 / 10
work_type0 / 10string0 / 10
building_type8 / 10string0 / 2
use_type8 / 10string0 / 2
cost_flag0 / 10string0 / 10
application_type_label0 / 10string0 / 10
tags0 / 10object0 / 10
tag_confidence0 / 10object0 / 10
tagged_at0 / 10string0 / 10
tag_version0 / 10string0 / 10
How the score is calculated, its limitations, and how to correct an assessment →

About this data

Chicago building permit records with parsed costs, full addresses, and rule-derived tags (work_type, building_type, use_type, value_category). Includes 95.5% cost population and confidence scores per tag. Addresses delivered as complete strings; building/use type classifications are keyword-derived and may be null.

Retrieve with your agent or Python

Create an account and configure DATABAZAAR_API_KEY. This example retrieves free or already purchased data; it never makes a purchase. For a multi-file dataset, choose a file index from the manifest.

Download the Python example
python3 retrieve-dataset.py cb609c91-3fb6-4048-b10d-5bc7395f07ea --output dataset.bin
Full supplier documentation
Original supplier listing: Chicago Building Permits 2000-2026 - 848,796 Records, Cleaned & Tagged (Free) 848,796 City of Chicago building permit records (2000-2026), cleaned, deduplicated, and rule-tagged for direct use by AI agents and analytics. Free. WHAT THIS IS Chicago's public permit history, normalised to an analysis-ready schema with parsed costs, full addresses, and a tag layer. No scraping or cleaning work required. WHAT'S IN EVERY ROW - permit_id, status (normalised + raw), application_type (permit type) - date_lodged / date_decided (validated ISO-8601) - property_address (full street address string, 99% populated) - suburb: Chicago community area (1-77) - estimated_cost (integer USD) - populated for 810,712 of 848,796 rows (95.5%) - Full work_description text - Tags: work_type, building_type, use_type, value_category - cost_flag: 'ok' vs 'suspect' (filer-reported values >= $50M, retained but flagged) - Per-tag confidence + a flattened `tags` list for filtering - Provenance: source_url, fetched_at, license_note on every row TAG COVERAGE - work_type - alteration 375,353; signage 55,159; new_build 31,972; elevator 22,359; demolition 21,961; scaffolding 8,965; porch 3,096 (+ unclassified) - value_category - low <$100k: 709,151 | mid $100k-1M: 84,698 | high >=$1M: 16,448 | suspect: 414 - building_type - residential 63,246; commercial 47,497; institutional 8,637; industrial 3,419; mixed 1,353 - use_type - housing 54,797; office 26,958; retail 12,985; hospitality 7,557; education 5,646; infrastructure 4,205; health 3,314 HONEST LIMITATIONS - Addresses are delivered as the complete `property_address` string; Chicago's house-number/street components are not split into separate columns. - `suburb` is the Chicago community-area NUMBER (1-77), not a name. - building_type and use_type are keyword-derived from the work description; many rows do not state enough to classify (left null, not guessed). - Costs are filer-reported and range from negative values to a 9,999,999,999 placeholder. cost_flag='suspect' marks values >= $50M; filter cost_flag='ok' for quantitative work. - 349 rows with no filing date were quarantined, not silently dropped. FORMAT Parquet, 72 MB, 28 columns. Schema and data dictionary included. SOURCE & LICENSE Public record from the City of Chicago via Chicago Open Data (data.cityofchicago.org, dataset ydr8-5enu). Attribution required. No personal data; PII (phones, emails, SSN) redacted at clean time. Redistribution of raw source rows prohibited; this cleaned/tagged compilation and its derived tags are the licensed work.

Schema

NameTypeDescription
permit_idstring
jurisdictionstring
source_urlstring
statusstring
application_typestring
date_lodgedstring
date_decidedstring
property_addressstring
suburbobject
descriptionstring
estimated_costnumber
value_categorystring
decoded_categorystring
decoded_confidencenumber
fetched_atstring
license_notestring
status_rawstring
clean_versionstring
cleaned_atstring
work_typestring
building_typestring
use_typestring
cost_flagstring
application_type_labelstring
tagsobject
tag_confidenceobject
tagged_atstring
tag_versionstring

Sample Data

Preview a sample of the data before downloading.

Public sample only. Sign in to retrieve the full dataset, including free datasets.

For AI Agents

Via MCP Server
# 1. Add to your agent's MCP config (claude_desktop_config.json or similar):
{
  "mcpServers": {
    "databazaar": { "command": "npx", "args": ["databazaar-mcp"] }
  }
}

# 2. Your agent can then call:
search_datasets({ query: "Chicago Building Permits" })
// Found: cb609c91-3fb6-4048-b10d-5bc7395f07ea
get_download_url({ dataset_id: "cb609c91-3fb6-4048-b10d-5bc7395f07ea" })  // free — sign in with MCP OAuth first
Via REST API
# Free dataset — sign in or use your account API key:
curl https://api.databazaar.io/datasets/cb609c91-3fb6-4048-b10d-5bc7395f07ea/download-url -H "Authorization: Bearer $DATABAZAAR_API_KEY"