Files · boundaries
Map boundaries
GeoJSON boundaries for US states, counties and 119th Congress congressional districts (Census 2025 cartographic boundary files at 1:20m and 1:5m) and world countries (Natural Earth 1:110m and 1:50m). Every feature's id is the location id the rest of the family uses (us-ca, us-county-06037, usa), so a map joins to any dataset by id. index.json lists every layer with its source, vintage and caveats.
- Updates
- Yearly
- Coverage
- —
- Current version
- —
- Last published
- —
- Validation
- —
- License
- US Government work + Public Domain
- Commercial use
- Allowed
Files
The files of the current version, served from the API.
- Loading the file list…
Use the API
Fetch the metadata for the list of files, then any file by its path. See the docs for versions, caching and errors.
curl
# The current version and its files
curl -s "https://api.visualizedata.dev/v1/boundaries"Python (polars)
import json
from urllib.request import urlopen
meta = json.load(urlopen("https://api.visualizedata.dev/v1/boundaries"))
for f in meta["downloads"]:
print(f["name"], f["bytes"], f["url"])JavaScript
const meta = await (await fetch("https://api.visualizedata.dev/v1/boundaries")).json();
console.log(meta.version, meta.downloads);Schema
This dataset publishes files without a fixed column schema.
Source and license
- Source
- U.S. Census Bureau 2025 Cartographic Boundary Files (state, county, 119th Congress congressional district; 1:20,000,000 and 1:5,000,000) and Natural Earth Admin 0 Countries v5.1.2 (1:110m, 1:50m)
- Publisher
- U.S. Census Bureau; Natural Earth
- License
- US Government work (public domain in the United States) and Public Domain (
LicenseRef-US-Government-Work AND LicenseRef-Public-Domain) - Commercial use
- Allowed
Credit the source with this exact text:
Source: U.S. Census Bureau, 2025 Cartographic Boundary Files. Made with Natural Earth. Free vector and raster map data @ naturalearthdata.com.
Checked every 30 days. If the source hasn't changed in 400 days, the status page flags it as stale.
Endpoints
Every URL for this dataset. To pin the current version, put it after the id:
/v1/boundaries@<version>.
The API reference describes each response.
| What | URL |
|---|---|
| Metadata: version, coverage, downloads, validation | /v1/boundaries |
| Versions and monthly snapshots | /v1/boundaries/versions |
| One file, at the path listed in the metadata | /v1/boundaries/{path} |