Free · No auth required

USPS ZIP Locale Detail

Auto-updated JSON mirror of the USPS PostalPro ZIP Locale Detail dataset. Fetch state-level or full data directly from static endpoints — no API key, no rate limits, no server.

Base URL

HTTPS

https://madhatter349.github.io/postalpro-zip-locale

Endpoints

GET /data/zip_locale_detail.json Full dataset +

Returns every ZIP locale record in a single JSON array. Large file — consider using a state-specific endpoint when possible.

Example

fetch('https://madhatter349.github.io/postalpro-zip-locale/data/zip_locale_detail.json')
  .then(r => r.json())
  .then(data => console.log(data.length, 'records'))

GET /data/states/{STATE}.json Filter by state +

Returns all records for a given state. Use the 2-letter state abbreviation in uppercase (e.g. CA, NY, TX).

Example

fetch('https://madhatter349.github.io/postalpro-zip-locale/data/states/CA.json')
  .then(r => r.json())
  .then(data => console.log(data))

GET /data/last_updated.txt Last update date +

Returns the date USPS last published a new version of the dataset. Plain text response.

Example

fetch('https://madhatter349.github.io/postalpro-zip-locale/data/last_updated.txt')
  .then(r => r.text())
  .then(date => console.log('Last updated:', date))

Try It

Enter a 2-letter state code to fetch its data live.

Record Schema

Field	Type	Description
area_name	string	USPS area name
area_code	string	USPS area code
district_name	string	USPS district name
district_no	string	USPS district number
delivery_zipcode	string	5-digit ZIP code
locale_name	string	Post office / locale name
physical_delivery_address	string	Street address of the post office
physical_city	string	City
physical_state	string	2-letter state code
physical_zip	string	Physical location ZIP
physical_zip4	string\|null	ZIP+4 extension

Available States

Click any state to view its JSON.