Zip Code API

Overview

This API allows users to search information of a zipcode, or pull a random zipcode.

Base URL

https://api.msmc.cc/api/zipcode

Routes

Search Zipcode

Method: GET
Endpoint: /:zip
Options:

• :zip - specify zip code to search

Example Request:
https://api.msmc.cc/api/zipcode/74747

Example Response:

[
  {
    "zip": "74747",
    "state": "Oklahoma",
    "county": "Bryan",
    "city": "Kemp",
    "timezone": "America/Chicago",
    "coordinates": "33.77368, -96.35609"
  }
]

Example Error:

{
  "error": "zipcode not found"
}

Random Zipcode

Method: GET
Endpoint: /zipcode/random

Example Request:
https://api.msmc.cc/api/zipcode/random

Example Response:

[
  {
    "zip": "56063",
    "state": "Minnesota",
    "county": "Blue Earth",
    "city": "Madison Lake",
    "timezone": "America/Chicago",
    "coordinates": "44.21914, -93.82015"
  }
]

Resources

1. United States Postal Service - https://www.usps.com/
2. Zip Codes Wikipedia - https://en.wikipedia.org/wiki/ZIP_Code
3. US Zip Code map - https://www.50states.com/zipcodes/

Support

For support, email [email protected]