US Zip Code API V2 is now available. See our release Note

US Zip Code API

The US Zip Code API v2 delivers fast, reliable access to United States ZIP code data through a developer-friendly REST API. Retrieve ZIP code details, validate ZIP codes, search by city or state, calculate distances, and perform radius searches using any of our available endpoints.

Unlike basic ZIP code APIs that rely only on USPS data, this API integrates multiple authoritative datasets to provide enriched geographic, demographic, and economic insights—allowing developers to access powerful location intelligence from a single unified API.

 Get API Key  View Docs

Get Started In 4 Easy Steps

  1. Register to one of our subscription tiers
  2. Get Your API Key
  3. Send your First Request (see example on right)
  4. Receive structured Zip Code Data

Sample Request

Get started right away, copy the code below to try out.

curl -X GET "https://global.metadapi.com/zipc/v2/zipcodes/90210" -H "Accept: application/json" -H "Ocp-Apim-Subscription-Key: YOUR-API-KEY"

Sample Response

{
	"links": {
        "self": "/zipc/v2/zipcodes/90210"
    },
    "meta": {
        "count": 1
    },
    "data": [
        {
            "zipCode": "90210",
            "uspsMainCityKey": "Z20259",
            "uspsMainCityName": "BEVERLY HILLS",
            "titleCaseCityName": "Beverly Hills",
            "zipClassificationCode": "N",
            "zipClassificationDesc": "Non-Unique Zip"
		}
	]
}
+ 32 more attributes available
View full schema →

Endpoints

Endpoint Endpoint Name Description Documentation
/zipc/v2/zipcodes/{zipcode} Get Zip Code Returns all details for that zip code. Documentation
/zipc/v2/zipcodes Search Zip Codes Returns a list of zip codes. Includes 16 query string parameters that can help you filter your search criteria. Documentation
/zipc/v2/distance Distance Between 2 Zip Codes Gets the distance (in miles and kilometers) between 2 zip codes passed as parameters. Documentation
/zipc/v2/distancecoord Distance Between Zip Code and latitude longitude coordinates Calculate the geographic distance between a specified U.S. ZIP Code and a set of latitude and longitude coordinates. Documentation
/zipc/v2/radius Zip Codes within Radius Returns the zip codes that fall within the specified radius of another zip code. Documentation
/zipc/v2/msagroups Search Metropolitan Statistical Areas This end point lists all the Metropolitan and Micropolitan Statistical Areas in the United States. Documentation
/zipc/v2/msagroups/{msagroup} Metropolitan Statistical Areas Detail Gets the details of a single Metropolitan Statistical Area code passed as a path parameter. Documentation
/zipc/v2/zipcodes/{zipcode}/soi IRS Statistics of Income by Zip Code Individual Income Tax Statistics by zip code. More than 160 statistical attributes available. Documentation
/zipc/v2/status Zip Code API Status Check status of Zip Code API Documentation

Data Sources

USPS Official Zip Database

Official USPS code values and descriptions for zip code data. Updated every month.

Census Bureau Gazetteer Files

U.S. Gazetteer Files provide a listing of all geographic areas for zip codes.

Census Bureau Decennial Census

The decennial census provides population statistics every 10 years for the US.

U.S. Office of Management and Budget

Logical groupings for metropolitan statistical areas.

Federal Information Processing Series

Federal standardized codes to represent states, territories and county locations.

ANSI

American National Standards Institute codes and descriptions.

IRS Statistics of Income

Annual statistics of income by Zip Code published by the IRS

Additional Details

Support

Email support for free tier subscriptions and dedicated support for paid subscriptions.

Free to Try

We offer a free tier that allows you to try the full functionality of the zip code API.

JSON Responses

Well structured JSON responses with a very complete and enhanced data model for US (United States) zip codes.

Great Documentation

Full API documentation for all endpoints with sample responses, code generators, github repository with code samples and blog articles with tutorials

Fast API Responses

Millisecond response times for Zip Code API calls.

Always Up to Date

The Zip Code database is updated monthly with the latest Zip Code changes from USPS (United States Postal Service).

Pricing

FreeTest Workloads$0/Month

  • 5,000 API Calls/Month
  • 2MB Monthly Bandwidth
  • 1 Concurrent Call /second
  • Email Support
  • Register

ProfessionalProduction Workloads$275/Month

  • 13,000,000 API Calls/Month
  • Unlimited Monthly Bandwidth
  • 5 Concurrent Calls /second
  • Dedicated Support
  • Register