---
title: "Query normalized Census BPS county-month permit rows"
method: GET
path: "/api/v1/data/permits/census-bps/county-monthly"
tags: ["Data"]
---

# Query normalized Census BPS county-month permit rows

`GET /api/v1/data/permits/census-bps/county-monthly`

## Request

- Base URL: `https://worldcastr.com`
- URL: `https://worldcastr.com/api/v1/data/permits/census-bps/county-monthly`
- Auth: none required

Returns public, normalized Census Building Permits Survey county-month rows from Worldcastr'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.

## Query parameters

- `year` integer
- `month` integer
- `kind` 'current_month' | 'year_to_date'
- `county_fips` string
- `state_fips` string
- `limit` integer
- `history` boolean
- `summary` boolean

## Response `200`

Normalized Census BPS county-month row response

- CensusBpsCountyMonthlyResponse
  - `schema_id` string, required
  - `asset_id` string, required
  - `source_id` string, required
  - `data_snapshot_id` string, required
  - `record_count` integer, required
  - `filters` object, required
  - `manifest` CensusBpsCountyMonthlyManifestSummary, required
    - `schema_id` string, required
    - `generated_at` string, date-time, required
    - `run_id` string, required
    - `source_id` string, required
    - `source_official_url` string, uri
    - `source_prefix_uri` string
    - `normalized_prefix_uri` string, required
    - `latest_manifest_uri` string
    - `manifest_uri` string
    - `latest_run_manifest_uri` string
    - `latest_data_manifest_uri` string
    - `normalization_version` string
    - `source_object_count` integer
    - `partition_count` integer, required
    - `record_count` integer, required
    - `partition_bytes` integer
    - `latest_current_month` CensusBpsCountyMonthlyPartition, required
      - `year` integer, required
      - `month` integer, required
      - `kind` 'current_month' | 'year_to_date', required
      - `source_uri` string, required
      - `source_bytes` integer
      - `source_etag` string, nullable
      - `source_last_modified` string, date-time, nullable
      - `normalized_uri` string, required
      - `public_path` string, required
      - `public_url` string, uri
      - `record_count` integer, required
      - `bytes` integer, required
      - `metric_totals` object, required
        - `total_buildings` integer
        - `total_units` integer
        - `total_value_usd` integer
    - `metric_totals` object
    - `settlement_policy` object, required
      - `resolution_grain` string
      - `resolution_basis` string
      - `canonical_value` string
      - `revision_policy` string
      - `independent_verification` string, uri
  - `partitions` CensusBpsCountyMonthlyPartition[], required
    - `year` integer, required
    - `month` integer, required
    - `kind` 'current_month' | 'year_to_date', required
    - `source_uri` string, required
    - `source_bytes` integer
    - `source_etag` string, nullable
    - `source_last_modified` string, date-time, nullable
    - `normalized_uri` string, required
    - `public_path` string, required
    - `public_url` string, uri
    - `record_count` integer, required
    - `bytes` integer, required
    - `metric_totals` object, required
      - `total_buildings` integer
      - `total_units` integer
      - `total_value_usd` integer
  - `records` CensusBpsCountyMonthlyRecord[], required
    - `schema_id` string, required
    - `record_id` string, required
    - `source_id` string, required
    - `source_record_id` string
    - `source_snapshot_id` string, required
    - `source_uri` string, required
    - `source_official_url` string, uri
    - `normalization_version` string, required
    - `geography` object, required
      - `entity_type` 'county'
      - `county_fips` string
      - `state_fips` string
      - `county_code` string
      - `county_name` string, nullable
      - `region_code` string, nullable
      - `division_code` string, nullable
    - `period` object, required
      - `year` integer
      - `month` integer
      - `survey_date` string
      - `period_start` string, date
      - `period_end` string, date
      - `kind` 'current_month' | 'year_to_date'
      - `source_vintage` string
      - `retrieved_at` string, date-time, nullable
      - `available_at` string, date-time, nullable
    - `metrics` object, required
    - `quality_flags` string[], required
    - `missing_reason` string, nullable
    - `published_at` string, date-time
  - `access` object, required
  - `_links` object, required

## Other responses

- `400`: Invalid filter combination

---

[API](https://skmtc.dev/worldcastr/apis/worldcastr-api.md) · [All operations](https://skmtc.dev/worldcastr/apis/worldcastr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldcastr/apis/worldcastr-api/revisions/2cf1606dc8e1?raw)