PHP Classes

PHP USPS API Zip Code: Get the zip code of a given location with USPS API

Recommend this page to a friend!
  Info   View files Documentation   View files View files (4)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not yet rated by the usersTotal: 115 All time: 9,471 This week: 225Up
Version License PHP version Categories
usps-zipcode 1.2GNU General Publi...5PHP 5, E-Commerce, Web services


This package is specific mainly for applications used in United States United States .

This class can Get the zip code of a given location with USPS API.

It can send a HTTP request to the USPS API Web server to request the zip code for a given physical address in the United States.

The class can parse the response and return the zip code that was found for that address.

Innovation Award
PHP Programming Innovation award nominee
January 2019
Number 4

Prize: One downloadable copy of PhpED Professional
Many applications that deal with addresses of people or companies need to know the addresses where they are located, so they can send them postal mail or parcels.

One of the details that is necessary to know about an address is the zip code.

This class can determine the zip code of a given location using the street address and city and the USPS API to find out the zip code of location in the United States.

Manuel Lemos
Picture of Jason Olson
  Performance   Level  
Name: Jason Olson is available for providing paid consulting. Contact Jason Olson .
Classes: 4 packages by
Country: United States United States
Age: ???
All time rank: 3242434 in United States United States
Week rank: 703 Up69 in United States United States Up
Innovation award
Innovation award
Nominee: 1x



This CLASS is designed to take advantage of the USPS API for looking up the zip code for a given physical address. There is very little examples of implementing the USPS API in PHP.


When you instantiate the class, include the API key. See the example.php file for usage. If you don't have a valid API, you can get one free at

Revision History:

  • 1.0 Initial Release
  • 1.1 Moved into its own namespace, api key defined when class is instantiated, moved the sample code into it's own file.


This is also a test for me as this is the first time I've developed code in the public using git. Most code has been for private repositories. This testing will be integrated with phpStorm.


GNU General Public License v3.0 (GNU GPLv3)

  Files folder image Files  
File Role Description
Accessible without login Plain text file example.php Example Example script
Accessible without login Plain text file LICENSE Lic. License text
Accessible without login Plain text file Doc. Documentation
Plain text file USPS.php Class Class source

 Version Control Unique User Downloads Download Rankings  
This week:0
All time:9,471
This week:225Up