Census State Building Permit Change Monitor

Compare the two newest official U.S. Census Building Permits Survey state releases and immediately see where residential construction authorization is accelerating or slowing. The Actor converts Census monthly files into clean, ranked state-level change records with housing-unit, construction-value, single-family, multifamily, and reported-coverage context.

This is a national housing-development signal rather than a city permit lead scraper. It answers which states changed most since the prior monthly release? without requiring users to download spreadsheets, understand Census file layouts, or maintain their own month-over-month comparison pipeline.

What it does

• Discovers the two newest Census state current-month files automatically.
• Compares all 50 states and the District of Columbia.
• Ranks total authorized housing units, single-family units, units in buildings with five or more units, or total authorized construction value.
• Filters by two-letter state code, direction, and minimum absolute percentage change.
• Preserves the current and previous official source URL on every record.
• Reports estimated totals alongside the share represented by responding permit offices, so users can judge coverage.
• Produces a compact SUMMARY record even when filters return no dataset rows.
• Uses bounded, keyless government downloads with no browser, proxy, login, or personal data.

Buyer workflows

Construction-material suppliers can rank states where authorized residential units are expanding. Homebuilders and land teams can add a state-level momentum signal to market-selection research. Banks, housing analysts, and commercial real-estate teams can monitor broad development direction. Economic researchers and newsrooms can automate a reproducible monthly comparison instead of manually reconciling Census releases.

The output is intentionally an aggregate market indicator. It does not identify individual permit applicants, property owners, contractors, addresses, or survey respondents.

Example input

{
  "states": ["CA", "TX", "FL", "AZ"],
  "metric": "totalUnits",
  "minAbsolutePercentChange": 5,
  "direction": "all",
  "sortBy": "absolutePercentChange",
  "maxResults": 25
}

Leave states empty to compare every state and DC. Supported metrics are:

• totalUnits: all authorized housing units across structure types.
• singleFamilyUnits: authorized units in one-unit buildings.
• multiFamilyFivePlusUnits: authorized units in buildings containing five or more units.
• totalValue: authorized construction value in thousands of dollars.

Example output

{
  "recordKey": "census-bps-state-202606-06-totalUnits",
  "state": "California",
  "stateCode": "CA",
  "stateFips": "06",
  "currentPeriod": "202606",
  "previousPeriod": "202605",
  "metric": "totalUnits",
  "currentValue": 10013,
  "previousValue": 9872,
  "absoluteChange": 141,
  "percentChange": 1.43,
  "direction": "increased",
  "currentTotalUnits": 10013,
  "previousTotalUnits": 9872,
  "currentSingleFamilyUnits": 5776,
  "currentMultiFamilyFivePlusUnits": 3784,
  "currentTotalValueThousands": 2989811,
  "currentReportedCoveragePercent": 60.1,
  "sourceUrl": "https://www2.census.gov/econ/bps/State/st2606c.txt",
  "previousSourceUrl": "https://www2.census.gov/econ/bps/State/st2605c.txt",
  "retrievedAt": "2026-08-24T13:00:00.000Z"
}

Values above illustrate the schema. Every real run derives its values and periods from the official files available at run time.

Interpreting reported coverage

Census state files contain both estimated totals and the portion represented by permit offices that reported. currentReportedCoveragePercent is the reported unit subtotal divided by the estimated unit total. It provides useful context, but it is not a statistical confidence interval or a quality grade.

A large monthly move can reflect real authorization activity, late reports, imputation, corrections, or changes in reporting coverage. Review the current and previous coverage values and official methodology before drawing a strong conclusion.

Source cadence and revisions

The Actor reads public comma-delimited state files from the official Census Building Permits Survey. Revised state data are generally released monthly on the seventeenth workday. Release timing can change, and prior figures can be affected by late reports or corrections.

The Census Bureau explains that the survey covers permit-issuing jurisdictions and reports units and valuation for new privately owned residential construction. The published files contain aggregate statistics; the Actor does not attempt to identify any respondent or combine Census data to reveal a person, household, business, or establishment.

This product uses U.S. Census Bureau data but is not endorsed or certified by the Census Bureau. Source data, file links, retrieval time, and the selected comparison period remain visible for auditability.

Empty results

A successful run may produce zero rows when no state matches the selected postal codes, direction, or minimum percentage threshold. Check the SUMMARY record to confirm the two periods compared and how many states matched. For a broad diagnostic run, clear states, choose all, set the minimum change to zero, and use totalUnits.

When the previous value is zero and the current value is positive, a normal percentage change is mathematically undefined. Such records use null for percentChange, preserve both values, and sort as exceptional moves.

Limits and responsible use

Inputs are capped at 100 results, while the source contains only 51 state/DC rows per month. Runtime defaults are bounded to 512 MB and 300 seconds, and the Actor operates with limited permissions. It does not use a proxy or make unbounded pagination requests.

Building Permit Survey figures can be estimated, revised, influenced by late reports, and unsuitable as a stand-alone local forecast. The Actor performs descriptive change detection only. It is not investment, lending, appraisal, legal, or construction advice. Verify material decisions against the official release, methodology, and any relevant local permit authority.