Postcodez Zip Code API
The Postcodez.com API is a RESTful service that provides United States postal data and zip codes in various formats. Because the service is free and doesn't require registration, we've mitaged the potential for abuse by rate limiting unreasonable requests and we truncate various types of output.Limitations
When searching zip codes as a distance from another zip code we'll return 100 results. If searching for zipcodes as a distance from a geographic point (lat/long) then, again, we'll limit results to 100. If you're searching multiple zip codes, we'll only accept 25 - regardless of whether they're valid or not.Need Something More?
If you feel that our limits don't meet the needs of your service, get in touch and we'll white-list your application.zipAPI.net
service is in 'beta' but will always be available and will always be free. Our full featured (registration based) API will become available at some point in the future at zipAPI.net
Distance Between two United States Zip Codes
Search Multiple Zip Codes
The format to search mutiple Zip Codes is as follows:
To retrieve details of a single
Zip Code, simply use the following:
Search Zip Codes Within a Radius of Another Zip Code
Search Zip Codes Within a Radius of GeoGraphic Coordinates
|404||No results found|
|405||Zip codes must be 5 characters in length|
|406||One zip code is invalid|
|421||Input is invalid|
|424||Source zipcode does not exist|
Example XML Error:
Rate Limiting Rules (General)
▶ 5 requests in 5 seconds results in a 15 second block time.|
▶ 10 requests in 30 seconds results in a 20 second block time.
▶ 100 requests in 3600 seconds results in a 600 second block time.
100 requests in a single hour is a general limit. We will increase this after the load to the server is known.
▶ 10 requests in 1 seconds results in a 86400 second block time.
10 requests in a single hour is a general limit. We will increase this after the load to the server is known.
▶ 25 requests in 3 seconds results in a 259200 second block time.
25 requests in three seconds results in a three-day block. These limits WILL increase.