Data

Query normalized Census BPS county-month permit rows

Returns public, normalized Census Building Permits Survey county-month rows from Homecastr's R2-backed permit/zoning surface. Defaults to the latest current-month partition and a capped row limit. For contract-style settlement, specify county_fips, year, month, and kind=current_month.

get/api/v1/data/permits/census-bps/county-monthly

Request

  • Base URL: https://www.homecastr.com
  • URL: https://www.homecastr.com/api/v1/data/permits/census-bps/county-monthly
  • Auth: none required

Query parameters

yearinteger

Four-digit survey year. Supply together with month unless history=true.

monthinteger

Survey month. Supply together with year unless history=true.

kind'current_month' | 'year_to_date'

Census BPS file kind.

county_fipsstring

Optional 5-digit county FIPS filter.

state_fipsstring

Optional state FIPS filter. Single-digit values are left-padded by the API.

limitinteger

Maximum rows to return.

historyboolean

Return a county time series across available partitions. Requires county_fips.

summaryboolean

Return manifest and partition metadata without row payloads.

Response

Normalized Census BPS county-month row response

schema_idstring required
asset_idstring required
source_idstring required
data_snapshot_idstring required
record_countinteger required
filtersobject required
accessobject required
_linksobject required

Example response

{
  "schema_id": "hc.permit_county_month.v1",
  "asset_id": "context.census_building_permits",
  "source_id": "census_bps_county_monthly_ascii",
  "manifest": {
    "schema_id": "hc.permit_county_month_manifest.v1",
    "source_id": "census_bps_county_monthly_ascii",
    "latest_current_month": {
      "year": 2026,
      "month": 5,
      "kind": "current_month"
    }
  },
  "partitions": [
    {
      "year": 2026,
      "month": 5,
      "kind": "current_month"
    }
  ],
  "records": [
    {
      "schema_id": "hc.permit_county_month.v1",
      "source_id": "census_bps_county_monthly_ascii",
      "geography": {
        "county_fips": "48201",
        "state_fips": "48"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.