SourceFinch Verified · Building Permits
Building Violations
Recent records from Building Violations on data.cityofchicago.org: up to 1,000 rows with stable identifiers for change monitoring. Contact columns are excluded.
- Healthy · 100% of observed runs successful
- Building Permits
- Cityofchicago open data
- data.cityofchicago.org
- Open data portal
- 11 typed fields
Monitor this sourceAPI, CLI, SDK and MCP
What changedNo changes in 7 days
At a glance
- Publisher
- Cityofchicago open data · homepage
- Category
- Building Permits
- Jurisdiction
- data.cityofchicago.org
- Publisher updates
- Updated by the publisher; typically daily or weekly
- Recommended schedule
- Daily for your monitor; SourceFinch verifies the recipe daily
- Records per run
- 1,000 in the latest run
- Record key
id- Acquired from
- Open data portal:
https://data.cityofchicago.org/resource/22u3-xenr.json?$select=id,violation_last_modified_date,violation_date,violation_code,violation_status,violation_description,violation_inspector_comments,violation_ordinance,inspector_id,inspection_number,inspection_status&$limit=1000&$order=id - Recipe
- v1.0.0, approved November 17, 2026
- Version notes
- First Verified version generated 2026-11-17 from batch backlog.
- Verified since
- November 17, 2026
- Last green run
- November 17, 2026
- Changes, last 7 days
- 0 · see what changed
What the data contains
Open data published on data.cityofchicago.org as “Building Violations”. Each daily run reads up to 1,000 rows through the portal's SODA API, naming only non-contact columns. A monitor reports new and changed rows inside the cohort. Leaving the cohort does not establish deletion. SourceFinch is independent of the publisher.
Fields and types
Every record has these fields. The key field id identifies a record across runs, so changes are reported field by field.
| Field | Type | Description |
|---|---|---|
idkey | string | Publisher field `id`. The record key. |
violation_last_modified_date | datetime, nullable | Publisher field `violation_last_modified_date`. |
violation_date | datetime, nullable | Publisher field `violation_date`. |
violation_code | string, nullable | Publisher field `violation_code`. |
violation_status | string, nullable | Publisher field `violation_status`. |
violation_description | string, nullable | Publisher field `violation_description`. |
violation_inspector_comments | string, nullable | Publisher field `violation_inspector_comments`. |
violation_ordinance | string, nullable | Publisher field `violation_ordinance`. |
inspector_id | string, nullable | Publisher field `inspector_id`. |
inspection_number | string, nullable | Publisher field `inspection_number`. |
inspection_status | string, nullable | Publisher field `inspection_status`. |
Sample output
The first 5 of 1,000 records from SourceFinch's own run on November 17, 2026, exactly as delivered.
| Field | Record 1 | Record 2 | Record 3 | Record 4 | Record 5 |
|---|---|---|---|---|---|
id | 1001846 | 1001847 | 1002009 | 1002038 | 1002039 |
violation_last_modified_date | 2008-05-20T11:55:49.000 | 2008-05-20T11:55:49.000 | 2011-12-07T11:58:27.000 | 2006-11-16T11:14:46.000 | 2006-11-16T11:37:58.000 |
violation_date | 2007-03-15T00:00:00.000 | 2007-03-15T00:00:00.000 | 2009-04-27T00:00:00.000 | 2006-10-02T00:00:00.000 | 2006-10-02T00:00:00.000 |
violation_code | EV0065 | EV0117 | EV0252 | 199029 | 199029 |
violation_status | COMPLIED | COMPLIED | COMPLIED | OPEN | OPEN |
violation_description | TEST G & S PASS ELE | REP/REPL DEF ALARM BELL PASS | REMOVE DEBRIS FROM PIT PASS | OPEN TYPE VIOLATION | OPEN TYPE VIOLATION |
violation_inspector_comments | FULL LOAD | PROPERLY PROGRAM EMERGENCY PHONES IN BOTH CARS | — | RE: BOTH CARS-1. REPAIR DOOR RESTRICTORS TO OPRATE PROPERLY. BOTH CARS. | 2. INSTALL MISSING SIGHT GUARDS ON 1ST FLOOR LANDING DOORS. BOTH CARS. |
violation_ordinance | Test governor and car safety and submit copy of test results to Elevator Bureau for passenger elevator. (13-156-820, 13-20-120) | Repair or replace defective emergency signal for passenger elevator. (13-156-010, 13-20-120, ANSI A17.1-1971, rule 211.1) | Remove accumulated debris from pit for passenger elevator. (13-156-010, 13-20-120) | — | — |
inspector_id | 541666 | 541666 | 541348 | 541348 | 541348 |
inspection_number | 2089609 | 2089609 | 10233143 | 1125132 | 1598831 |
inspection_status | PASSED | PASSED | PASSED | FAILED | FAILED |
Sample as JSON
[
{
"id": "1001846",
"inspector_id": "541666",
"violation_code": "EV0065",
"violation_date": "2007-03-15T00:00:00.000",
"violation_status": "COMPLIED",
"inspection_number": "2089609",
"inspection_status": "PASSED",
"violation_ordinance": "Test governor and car safety and submit copy of test results to Elevator Bureau for passenger elevator. (13-156-820, 13-20-120)",
"violation_description": "TEST G & S PASS ELE",
"violation_inspector_comments": "FULL LOAD",
"violation_last_modified_date": "2008-05-20T11:55:49.000"
},
{
"id": "1001847",
"inspector_id": "541666",
"violation_code": "EV0117",
"violation_date": "2007-03-15T00:00:00.000",
"violation_status": "COMPLIED",
"inspection_number": "2089609",
"inspection_status": "PASSED",
"violation_ordinance": "Repair or replace defective emergency signal for passenger elevator. (13-156-010, 13-20-120, ANSI A17.1-1971, rule 211.1)",
"violation_description": "REP/REPL DEF ALARM BELL PASS",
"violation_inspector_comments": "PROPERLY PROGRAM EMERGENCY PHONES IN BOTH CARS",
"violation_last_modified_date": "2008-05-20T11:55:49.000"
},
{
"id": "1002009",
"inspector_id": "541348",
"violation_code": "EV0252",
"violation_date": "2009-04-27T00:00:00.000",
"violation_status": "COMPLIED",
"inspection_number": "10233143",
"inspection_status": "PASSED",
"violation_ordinance": "Remove accumulated debris from pit for passenger elevator. (13-156-010, 13-20-120)",
"violation_description": "REMOVE DEBRIS FROM PIT PASS",
"violation_inspector_comments": null,
"violation_last_modified_date": "2011-12-07T11:58:27.000"
},
{
"id": "1002038",
"inspector_id": "541348",
"violation_code": "199029",
"violation_date": "2006-10-02T00:00:00.000",
"violation_status": "OPEN",
"inspection_number": "1125132",
"inspection_status": "FAILED",
"violation_ordinance": null,
"violation_description": "OPEN TYPE VIOLATION",
"violation_inspector_comments": "RE: BOTH CARS-1. REPAIR DOOR RESTRICTORS TO OPRATE PROPERLY. BOTH CARS.",
"violation_last_modified_date": "2006-11-16T11:14:46.000"
},
{
"id": "1002039",
"inspector_id": "541348",
"violation_code": "199029",
"violation_date": "2006-10-02T00:00:00.000",
"violation_status": "OPEN",
"inspection_number": "1598831",
"inspection_status": "FAILED",
"violation_ordinance": null,
"violation_description": "OPEN TYPE VIOLATION",
"violation_inspector_comments": "2. INSTALL MISSING SIGHT GUARDS ON 1ST FLOOR LANDING DOORS. BOTH CARS.",
"violation_last_modified_date": "2006-11-16T11:37:58.000"
}
]Evidence behind every value
- Each run keeps the publisher's exact response, hashed with SHA-256. This sample came from a response with hash
0b2786cca87d2180d22b9538a36b60535254680b3aab4223d23c30b31f08ce63. - Every value records where it came from in that response: a JSON Pointer into the retained capture.
- Each run gets a signed manifest (Ed25519) timestamped by an RFC 3161 authority: this run's manifest hash is
b63525ffb5a46664032ae953e98ba55205b475b3101b436a8e7eb4db4a1bc2e5, timestamped November 17, 2026. - The compliance state at capture is recorded with the evidence: robots.txt hash and verdict, AI-preference signals, crawler identity and the usage rights below.
- Download any run as an evidence bundle (WACZ) and check it offline, without trusting SourceFinch:
sourcefinch verify-bundle run.wacz.
Terms posture and usage rights
- Terms
- Automated access permitted · publisher's terms
- robots.txt
- Allows this path · SHA-256
8cf8efc313d45d7d… - AI-preference signals
- None observed at review
- Public record
- Yes. Municipal/state open data portal dataset 22u3-xenr on data.cityofchicago.org.
- Reviewed
- November 17, 2026; next review May 17, 2027
- Licence basis
- Publisher's terms of use
- Commercial use
- Allowed
- Redistribution
- Allowed
- Attribution
- Required (text below)
Published on the data.cityofchicago.org open data portal for public use. Anonymous SODA API access needs no key. Portal robots.txt typically allows /resource/ with a crawl delay. Contact-name columns are not requested by this recipe.
Cityofchicago open data (data.cityofchicago.org). SourceFinch is independent of the publisher.
Usage rights travel with every record SourceFinch delivers (API, exports, webhooks and evidence bundles). They are our documented understanding of the publisher's stated terms, not legal advice.
Reliability
- Runs, last 30 days
- 1
- Green
- 100%
- Failed
- 0
- Median run time
- 1.4 s
- Latest run
- success, November 17, 2026
Measured on completed runs of this recipe version across SourceFinch, anonymized, within a rolling 30-day window. First successful observation: November 17, 2026. A new recipe has only the history collected since that date; this is not a 30-day uptime guarantee.
Use it
Every surface creates the same monitor from this Verified recipe. Monitors keep record history, report field-level changes and deliver by webhook, export or email. You confirm you have the right to collect the source (rights: true).
Console
Open this recipe in the console: it preserves the reviewed URL, fields and record key. Review the latest captured sample, confirm source rights, and choose a schedule before creating your monitor.
Portable recipe
Copy into the console's Import or share a recipe panel to customize fields, types and schedules. This configuration contains no captured records or workspace IDs.
{
"schema": "sourcefinch/source@1",
"name": "Building Violations",
"url": "https://data.cityofchicago.org/resource/22u3-xenr.json?$select=id,violation_last_modified_date,violation_date,violation_code,violation_status,violation_description,violation_inspector_comments,violation_ordinance,inspector_id,inspection_number,inspection_status&$limit=1000&$order=id",
"recipe": {
"mode": "http",
"format": "json",
"items": "[*]",
"fields": {
"id": "id",
"inspector_id": "inspector_id",
"violation_code": "violation_code",
"violation_date": "violation_date",
"violation_status": "violation_status",
"inspection_number": "inspection_number",
"inspection_status": "inspection_status",
"violation_ordinance": "violation_ordinance",
"violation_description": "violation_description",
"violation_inspector_comments": "violation_inspector_comments",
"violation_last_modified_date": "violation_last_modified_date"
},
"required": [
"id"
],
"types": {
"violation_date": "datetime",
"violation_last_modified_date": "datetime"
}
},
"schedule": "daily",
"key_field": "id"
}source.json
The request body used by the API, CLI and SDK examples.
{
"name": "Building Violations",
"url": "https://data.cityofchicago.org/resource/22u3-xenr.json?$select=id,violation_last_modified_date,violation_date,violation_code,violation_status,violation_description,violation_inspector_comments,violation_ordinance,inspector_id,inspection_number,inspection_status&$limit=1000&$order=id",
"recipe": {
"mode": "http",
"format": "json",
"items": "[*]",
"fields": {
"id": "id",
"inspector_id": "inspector_id",
"violation_code": "violation_code",
"violation_date": "violation_date",
"violation_status": "violation_status",
"inspection_number": "inspection_number",
"inspection_status": "inspection_status",
"violation_ordinance": "violation_ordinance",
"violation_description": "violation_description",
"violation_inspector_comments": "violation_inspector_comments",
"violation_last_modified_date": "violation_last_modified_date"
},
"required": [
"id"
],
"types": {
"violation_date": "datetime",
"violation_last_modified_date": "datetime"
}
},
"key_field": "id",
"schedule": "daily",
"rights": true,
"catalog": {
"slug": "cityofchicago-building-violations",
"version_id": "0f5ab020-45e5-4d09-82f0-7eec38411890"
}
}REST API
Create an API key under Console → API keys. Reference: /docs/api.
# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/cityofchicago-building-violations -H "Authorization: Bearer $SOURCEFINCH_API_KEY"
# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
-H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d @source.json
# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
-H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"CLI
The sourcefinch CLI is not on npm yet; see /docs/cli.
sourcefinch login
sourcefinch catalog get cityofchicago-building-violations --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_IDTypeScript SDK
The SDK is not on npm yet; see /docs/sdk.
import { SourceFinch } from "@sourcefinch/sdk";
const sf = new SourceFinch({ apiKey: process.env.SOURCEFINCH_API_KEY });
const entry = await sf.catalog.get("cityofchicago-building-violations");
const source = await sf.sources.create({
catalog: { slug: entry.slug, version_id: entry.recipe.version_id },
name: entry.name.slice(0, 100),
url: entry.acquisition_path.endpoint,
recipe: entry.recipe.definition,
key_field: entry.recipe.key_field,
schedule: entry.recipe.schedule,
rights: true, // you confirm you have the right to collect this source
});
const run = await sf.runs.wait((await sf.runs.create(source.id)).id);
console.log(run.status);MCP
Remote MCP server with OAuth; see /docs/mcp.
claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp
# then ask your agent:
"Use SourceFinch to monitor Building Violations: get_catalog_source cityofchicago-building-violations,
then create_source with its create_source_args (dry run first), then run_source."Pricing
Each check is one run, whatever the number of records, and failed runs are free. On its default daily schedule this source uses about 30 runs a month, which fits the Free plan's 300 runs. It uses HTTP acquisition, so no browser runs are needed. See plans.
Related sources
More from Cityofchicago open data and in building permits.
SourceFinch is independent and is not affiliated with or endorsed by Cityofchicago open data. This page describes building violations as SourceFinch acquires it.