# Changelog of Building Permits API: SF, Seattle, Austin & more (open data) (`gapforge/building-permit-feed`) Actor

- **URL**: https://apify.com/gapforge/building-permit-feed/changelog.md
- **Full Actor documentation**: https://apify.com/gapforge/building-permit-feed.md

## Changelog

All notable changes to this Actor are recorded here. The format follows Keep a Changelog, and versions follow
Semantic Versioning (MAJOR.MINOR; a breaking output change means a new MAJOR).

### \[1.1] - 2026-11-16

#### Added in build 1.1.5 (2026-11-18, fix forward for the 1.1.4 audit)

- Field coverage: 28 new optional fields, empty where a city does not publish them: `parcelId`, `additionalParcelIds`,
  `siteCity`, `siteState`, `jurisdiction`, `councilDistrict`, `neighborhood`, `propertyClass`, `permitClass`,
  `statusDate`, `existingUse`, `proposedUse`, `stories`, `constructionType`, `existingUnits`, `proposedUnits`,
  `housingUnitsRemoved`, `housingUnitsNet`, `housingUnitsOnProperty`, `newAddedSqft`, `grossSqft`, `buildingCost`,
  `electricalCost`, `plumbingCost`, `mechanicalCost`, `architectCompany` (business-marker rule), `cityPermitUrl`, and
  `cityFields` for facts that one city alone publishes. Every source column and the reason for each one left out is in
  `ship/field-coverage.md`. No person field was added.

#### Fixed in build 1.1.5

- Cincinnati: several issued records under one permit number (for example an excavation and a building record) are
  each delivered, with the id `cincinnati:<permitNumber>:<recordType>`, and `sourceUrl` names the record type and issue
  date so it returns that one record. Before, the second record was dropped as a duplicate. Only-new schedules: a record
  that 1.1.4 already delivered is recognised and not charged again; a record 1.1.4 dropped is delivered once as new.
- San Francisco: a permit that covers several lots is delivered once from the row the city flags as its primary address
  (before: the first row read). The other lots are listed in `additionalParcelIds`. One-time effect in only-new mode:
  such a permit already delivered from another lot can come back once as `changed`, because its address now follows the
  city's flag.
- The only-new comparison still uses the 1.1.4 fields, so the new fields do not make every saved permit look changed.
  A change in a new field alone is not reported as `changed`.

#### Added

- Contractor trade, business address, business phone and licence numbers, where the source publishes them and the
  company name passes the existing business-marker rule. Fields that are not always filled are marked "where available".
- San Francisco firm name, firm address and licence numbers from the city's Building Permits Contacts dataset
  (3pee-9qhc, PDDL), joined on permit number. Person-name and agent-address columns are never requested or output.
- A TCPA / Do-Not-Call note on business phones: numbers are stored as the city published them and are not checked
  against any do-not-call list.

#### Fixed

- San Francisco contractor company, address and licence numbers come only from a contacts row whose role is contractor.
  A payor, expediter, architect, engineer or other role is never used, even when that firm's name carries a business
  marker. (The 1.1.1 beta had a broken role pattern and an any-role fallback.)
- `housingUnitsAdded` is filled only when the city publishes units added (Seattle) or proposed and existing counts
  (San Francisco). Austin's `housing_units` and Cincinnati's `housingunits` / `units` are the count on the property,
  not units added, and are no longer written to this field.
- Company names that are only OWNER or Owner Builder are left empty.

#### Changed

- East Baton Rouge Parish was removed. The data.brla.gov Terms of Service grant only a limited, non-commercial,
  personal-use licence and bar resale and data extraction, which does not allow commercial reuse in this tool.
- Cincinnati is kept. The municipal website's commercial-use bar at www.cincinnati-oh.gov applies to that site; the
  feed this tool reads is the public-domain dataset on data.cincinnati-oh.gov. The municipal site is not scraped.
- The profile and Store copy now say five cities, and describe the new business fields.

### \[1.0] - 2026-11-16

#### Added

- New building permits from six US city open-data feeds (San Francisco, Seattle, Austin, Cambridge MA, Cincinnati,
  East Baton Rouge Parish) in one row shape: permit number, normalised type, the city's own type code, status, dates,
  site location, ZIP, coordinates, estimated cost, housing units added and contractor company where the city publishes
  one.
- Filters: issue dates, permit types (new construction, alteration, demolition, electrical, plumbing, mechanical,
  roof, solar, other) and a minimum estimated cost.
- Only-new mode for scheduled runs: permits not delivered before, plus permits whose facts changed.
- A free notice row for each city whose feed is stale, cannot be read or changed its layout or licence.
- Pay per permit delivered; notice rows and skipped cities are free; the run stops at your max charge limit.
