Zip Code

General Information

This service is a custom built API that was built by The Easy API. It uses the latest Zip Code listing from the USPS and then combines data from other sources to make a complete zip code set.

Required Parameters

Field Required Description
zipcode Yes 5 Digit U.S. postal code

Found Zip Code

Request

https://json.theeasyapi.com/{api_key}/?service=zipcode&zipcode=90210

Response

{
  "zipcodes": {
    "zipcode": "90210",
    "cityname": "Beverly Hills",
    "citytype": "Primary",
    "countyname": "Los Angeles",
    "countyfips": "06037",
    "statename": "California",
    "stateabbr": "CA",
    "statefips": "06",
    "msacode": "4480",
    "areacode": "310/424",
    "timezone": "Pacific",
    "utc": "-8.0",
    "dst": "Y",
    "latitude": "  34.096629",
    "longitude": "-118.412426"
  }
}

Potential Errors

Request

https://json.theeasyapi.com/{api_key}/?service=zipcode&zipcode=00010

Response

{
  "zipcodes": {
    "errors": "1",
    "errorcode": "zipcode_1000",
    "reason": "Zip Codes Service - The zip code you provided does not match any data.  Please confirm that it is a valid 5 digit United States zip code."
  }
}

Documentation

Ready to sign up?

Get Started