{"contractVersion":"parcelops.connector.v1","name":"census-bps","displayName":"Census Building Permits","description":"Official county-level residential building-permit authorizations, housing units, and construction value.","tags":["census","building-permits","residential","housing","county","development"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"U.S. Census Bureau Building Permits Survey","sourceUrl":"https://www2.census.gov/econ/bps/County/","apiBaseUrl":"https://www2.census.gov/econ/bps/County","documentationUrl":"https://www.census.gov/construction/bps/index.html"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Monthly and year-to-date county files follow the Census publication schedule; annual files are also available."}},"coverage":{"geographic":{"status":"declared","value":["United States counties represented in the published BPS files"]},"temporal":{"status":"declared","value":{"start":"1995","notes":"The connector exposes the current county-file layout from 1995 forward."}}},"methods":{"total":2,"items":[{"name":"getCountyBuildingPermits","description":"Get one monthly, year-to-date, or annual county file, optionally filtered by FIPS.","requiredParams":["period","year"],"inputSchema":{"type":"object","properties":{"period":{"type":"string","enum":["current_month","year_to_date","annual"]},"year":{"type":"integer","minimum":1995,"maximum":2100},"month":{"type":"integer","minimum":1,"maximum":12},"stateFips":{"type":"string","pattern":"^\\d{2}$"},"countyFips":{"type":"string","pattern":"^\\d{3}$"},"limit":{"type":"integer","minimum":1,"maximum":500}},"required":["period","year"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Monthly and year-to-date county files follow the Census publication schedule; annual files are also available."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["BPS contains aggregate residential authorizations, not individual permits, parcel records, completions, or proof that construction occurred.","Estimated values include Census imputation; reported-only values are returned separately.","Nonresidential permit statistics were discontinued after 1995."]},{"name":"getServiceInfo","description":"Return file conventions, coverage, cadence, fields, and aggregate-data limitations.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1M","notes":"Monthly and year-to-date county files follow the Census publication schedule; annual files are also available."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["BPS contains aggregate residential authorizations, not individual permits, parcel records, completions, or proof that construction occurred.","Estimated values include Census imputation; reported-only values are returned separately.","Nonresidential permit statistics were discontinued after 1995."]}]},"caveats":["BPS contains aggregate residential authorizations, not individual permits, parcel records, completions, or proof that construction occurred.","Estimated values include Census imputation; reported-only values are returned separately.","Nonresidential permit statistics were discontinued after 1995."]}