🗺️ Complete US ZIP Code API: Access 41,000+ Verified Postal Records

Stop patching together incomplete data. Get instant access to the ultimate US ZIP code database featuring over 41,000 active postal codes. Each record comes fully enriched with city, county, state, timezone, area code, FIPS codes, and precise GPS coordinates. One actor. One run. Everything you need.

---

Why most ZIP code data falls short

You need accurate postal data. You find a dataset, pull it in, start filtering by state or county, and then the gaps show up. Rural ZIPs missing. Military codes absent. Territories like Guam and Puerto Rico nowhere to be found. You patch things together from multiple sources and still end up with duplicates, missing leading zeros, and codes that belong to the wrong city.

This actor was built to fix that.

---

What you get

The full US ZIP code list: standard delivery ZIPs, PO Box codes, unique-organization codes, and military APO/FPO/DPO codes. Every record has the same 13 fields, and every ZIP code is properly zero-padded (so 03086 stays 03086, not 3086).

Filter by any combination of:

• ZIP code or list of ZIP codes
• State (abbreviation or full name)
• City name
• County name
• Timezone (Eastern, Central, Mountain, Pacific, Alaska, Hawaii, Atlantic, and more)
• Area code (supports overlapping codes like 978/351)
• ZIP code type (Standard, PO Box, Unique, Military)
• State FIPS code
• County FIPS code

No filters? You get everything, up to your chosen limit. Default is 100 records. Set it to 41000 and pull the whole database in one shot.

---

What each record contains

{
  "zip_code": "90210",
  "zip_code_type": "S",
  "zip_city": "Beverly Hills",
  "zip_county": "Los Angeles",
  "county_fips": "06037",
  "zip_state": "California",
  "state_code": "CA",
  "state_fips": "6",
  "zip_msa": "4480",
  "zip_areacode": "310/424",
  "zip_timezone": "Pacific",
  "zip_latitude": 34.088808,
  "zip_longitude": -118.405655
}

---

Input

Parameter	Type	Default	Description
zipCode	array	—	List of ZIP codes to look up (e.g. ["10001", "90210"]). Returns all matching records.
stateCode	string	—	Two-letter state code. See accepted values below.
zipState	string	—	Full state name. See accepted values below.
zipCity	string	—	City name, partial match (e.g. "Los Angeles").
zipCounty	string	—	County name, partial match. See examples below.
zipTimezone	select	—	Timezone filter. See accepted values below.
zipAreaCode	string	—	Area code filter (e.g. "212"). Works with overlapping codes like "978/351".
zipCodeType	select	—	ZIP type. See accepted values below.
stateFips	string	—	Numeric state FIPS code (e.g. "6" for California).
countyFips	string	—	5-digit county FIPS code (e.g. "06037").
maxResults	integer	100	Max records to return. Min 1, max 41000.

---

Accepted values for zipCodeType

Value	Meaning
S	Standard — regular delivery zone
P	PO Box — serves PO Box addresses only
U	Unique — assigned to a single large organization (university, government agency)
M	Military — APO, FPO, and DPO codes used by the armed forces

---

Accepted values for zipTimezone

Value	Description
Eastern	Eastern Time (UTC-5 / UTC-4 DST)
Central	Central Time (UTC-6 / UTC-5 DST)
Mountain	Mountain Time (UTC-7 / UTC-6 DST)
Pacific	Pacific Time (UTC-8 / UTC-7 DST)
Alaska	Alaska Time (UTC-9 / UTC-8 DST)
Hawaii	Hawaii-Aleutian Time (UTC-10)
Atlantic	Atlantic Time — used by some US territories
UTC+9	Chamorro / Wake Island area
UTC+10	Guam, Northern Mariana Islands
UTC+11	Some Pacific territories
UTC+12	Marshall Islands, some Pacific islands
None	Unknown or not assigned

---

Accepted values for stateCode

NH ME VT MA CT NY NJ PA DE DC VA MD WV NC SC GA FL AL TN MS KY OH IN MI IA WI MN SD ND MT IL MO KS NE LA AR OK TX CO WY ID UT AZ NM NV CA HI OR WA AK RI PR GU AS VI MP MH FM PW AE AA AP

Military mail: AE (Europe/Africa/Canada), AA (Americas), AP (Pacific). Territories: PR (Puerto Rico), GU (Guam), AS (American Samoa), VI (US Virgin Islands), MP (Northern Mariana Islands), MH (Marshall Islands), FM (Federated States of Micronesia), PW (Palau).

---

Accepted values for zipState (full name)

Alabama, Alaska, Arizona, Arkansas, California, Colorado, Connecticut, Delaware, District of Columbia, Florida, Georgia, Hawaii, Idaho, Illinois, Indiana, Iowa, Kansas, Kentucky, Louisiana, Maine, Maryland, Massachusetts, Michigan, Minnesota, Mississippi, Missouri, Montana, Nebraska, Nevada, New Hampshire, New Jersey, New Mexico, New York, North Carolina, North Dakota, Ohio, Oklahoma, Oregon, Pennsylvania, Rhode Island, South Carolina, South Dakota, Tennessee, Texas, Utah, Vermont, Virginia, Washington, West Virginia, Wisconsin, Wyoming, Puerto Rico, Guam, American Samoa, Virgin Islands, Northern Mariana Islands, Marshall Islands, Federated States of Micronesia, Palau, Armed Forces - Europe/Africa/Canada, Armed Forces - Americas, Armed Forces - Pacific.

---

Example values for zipCounty (Partial match)

Since there are thousands of US counties, this field accepts any text string and performs a case-insensitive partial match. Examples include:

Rockingham, Merrimack, Grafton, Belknap, Carroll, Sullivan, Cheshire, Coos, Strafford, York, Cumberland, Sagadahoc, Oxford, Androscoggin, Franklin, Kennebec, Lincoln, Waldo, Penobscot, Los Angeles, Harris, Cook.

---

Example inputs

Look up a single ZIP code:

{
  "zipCode": ["10001"],
  "maxResults": 10
}

Look up multiple ZIP codes at once:

{
  "zipCode": ["10001", "90210", "33101", "60601"],
  "maxResults": 100
}

All standard ZIPs in Texas:

{
  "stateCode": "TX",
  "zipCodeType": "S",
  "maxResults": 2000
}

Find all ZIP codes in a specific county:

{
  "zipState": "New Hampshire",
  "zipCounty": "Rockingham",
  "maxResults": 1000
}

Find ZIP codes by area code (including overlaps):

{
  "zipAreaCode": "212",
  "maxResults": 100
}

All ZIPs in the Eastern timezone:

{
  "zipTimezone": "Eastern",
  "maxResults": 5000
}

Pull the full database:

{
  "maxResults": 41000
}

---

Output fields

Field	Type	Description
zip_code	string	5-digit ZIP code, zero-padded
zip_code_type	string	S = Standard, P = PO Box, U = Unique, M = Military
zip_city	string	Primary city name
zip_county	string	County name
county_fips	string	5-digit county FIPS code
zip_state	string	Full state name
state_code	string	Two-letter state abbreviation
state_fips	string	Numeric state FIPS code
zip_msa	string	Metropolitan Statistical Area code (0 if none)
zip_areacode	string	Telephone area code(s)
zip_timezone	string	Timezone name
zip_latitude	number	Latitude of ZIP centroid
zip_longitude	number	Longitude of ZIP centroid

---

About US ZIP codes

ZIP stands for Zone Improvement Plan. The USPS introduced the 5-digit format in 1963 to speed up mail sorting. The first digit represents a broad region (0 in the Northeast, 9 on the West Coast). The next two narrow it to a sectional center facility, and the last two point to a specific post office or delivery zone.

Beyond USPS, ZIP codes are used by UPS, FedEx, DHL, and virtually every shipping carrier to calculate rates and transit times. They show up in tax software, CRM systems, demographic tools, lead-gen forms, and mapping applications.

There are over 41,000 active ZIP codes in the US, ranging from 00501 in Holtsville, NY, to 99950 in Ketchikan, AK. The exact count depends on whether you include PO Box codes, military codes, and territories like Puerto Rico, Guam, American Samoa, the US Virgin Islands, and the Pacific island territories.

This actor includes all of them.

---

Use cases

• Address validation and enrichment: append city, county, state, timezone, and coordinates to any address list using only the ZIP code
• Territory and sales routing: pull all ZIPs for a specific state, county, or metro area and assign them to sales reps or service zones
• Logistics and shipping tools: filter by timezone or area code to plan delivery windows and regional carrier routing
• Lead qualification: enrich form submissions with geographic context before they hit your CRM
• Tax and compliance systems: look up state FIPS and county FIPS codes needed for tax jurisdictions
• Demographic research: combine ZIP-level geography with census or income data for market analysis
• App and SaaS development: use as a reference database for building ZIP lookup, autofill, or validation features

---

FAQ

Does this include Puerto Rico, Guam, and US territories?

Yes. The database covers all 50 states plus Washington DC, Puerto Rico, Guam, American Samoa, the US Virgin Islands, the Northern Mariana Islands, the Marshall Islands, and military APO/AE/AP codes.

Why do some ZIP codes only have 4 digits in my spreadsheet?

Spreadsheet tools like Excel and Google Sheets strip leading zeros from numeric columns. ZIP codes like 03086 (New Hampshire) become 3086. This actor detects and restores those leading zeros automatically, so every record in the output is a proper 5-digit ZIP.

Can I look up multiple ZIP codes at once?

Yes. Pass a list of strings in the zipCode field: ["10001", "90210", "33101"]. The actor returns all matching records.

What does the ZIP code type mean?

S (Standard) is a regular delivery zone. P (PO Box) serves only PO Box addresses at a specific post office. U (Unique) is assigned to a single large organization like a university or government agency. M (Military) covers APO, FPO, and DPO codes used by the armed forces.

How do I get the whole database?

Set maxResults to 41000 and run with no other filters. You'll get every record in one shot.

What are FIPS codes used for?

Federal Information Processing Standard (FIPS) codes are numeric identifiers for states and counties used by government agencies, census data, and many third-party data providers. If you're joining ZIP data to census or tax tables, matching on FIPS codes is often more reliable than matching on name strings.

Which timezones are in the database?

Eastern, Central, Mountain, Pacific, Alaska, Hawaii, Atlantic, UTC+9, UTC+10, UTC+11, UTC+12, and None. The non-standard offsets (UTC+9 through UTC+12) cover US territories and Pacific island territories in the Western Pacific.

---

Integrations

Connect the US ZIP Code Database with other apps using Apify integrations. Pipe results into Google Sheets, Airtable, a SQL database, or your own API via Make, Zapier, or webhooks. You can also schedule runs to keep a local copy of the database refreshed.