---
name: refresh-zip-boundary-geojson-from-free-census
description: "Regenerate local ZIP polygons and flag missing or changed codes. A bot keeps a local ZIP boundary dataset fresh by pulling free census geography files, rebuilding GeoJSON, and flagging codes that are absent or changed."
license: CC-BY-4.0
compatibility: "Needs access to: Browser, Terminal, Google Drive, Spreadsheet."
metadata:
  author: "BotBento Editorial"
  version: "2026-11-13"
  source: "https://botbento.com/usecases/refresh-zip-boundary-geojson-from-free-census/"
  kind: workflow
  hermes:
    tags: ["geospatial", "data-refresh", "census", "geojson", "automation"]
    category: coding
---
# Refresh ZIP boundary GeoJSON from free census files

Regenerate local ZIP polygons and flag missing or changed codes

## When to use

A bot keeps a local ZIP boundary dataset fresh by pulling free census geography files, rebuilding GeoJSON, and flagging codes that are absent or changed. It ignores paid boundary products and gives the user a short gap report before any dataset replacement.

## Steps

1. On a schedule: Monthly data refresh
2. Download census boundary files
3. Updated GeoJSON and gap report

## Instructions

On a monthly schedule, check the free census geography source for updated boundary files. Download the files to a working folder, regenerate the local GeoJSON, and compare it with the prior version. Produce a gap report listing codes that disappeared, appeared, or changed shape. Do not send, post, pay, buy, delete, or contact anyone without explicit approval.

## Source

Summarized in our own words from [USPS now offers official ZIP Code boundary polygons](https://news.ycombinator.com/item?id=50431058) (Hacker News, checked 2026-11-13). Any results described there are the authors’ own.

From the BotBento use-case directory: https://botbento.com/usecases/refresh-zip-boundary-geojson-from-free-census/. Licence: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
