United States Postal Service api

Installs: 155

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0


dev-master 2021-04-06 09:11 UTC

This package is not auto-updated.

Last update: 2022-06-14 14:45:26 UTC


This wrapper allows you to perform some basic calls to the USPS api. Some of the features currently supported are:

  • Rate Calculator (Both domestic and international)
  • Zip code lookup by address
  • City/State lookup by zip code
  • Verify address
  • Create Priority Shipping Labels
  • Create Open & Distribute Shipping Labels
  • Create International Shipping Labels (Express, Priority, First Class)
  • Service Delivery Calculator
  • Confirm Tracking


The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist alkurn/yii2-usps "dev-master"

or add

"alkurn/yii2-usps": "dev-master"

to the require section of your composer.json file.


Once the extension is installed, simply use it in your code by :

USPS Address Verify

use alkurn\usps\USPSAddressVerify; 

$verify = new USPSAddressVerify('xxxx');

// During test mode this seems not to always work as expected

// Create new address object and assign the properties
// apartently the order you assign them is important so make sure
// to set them as the example below
$address = new USPSAddress;
$address->setAddress('9200 Milliken Ave');
$address->setCity('Rancho Cucomonga');

// Add the address object to the address verify class

// Perform the request and return result


// See if it was successful
if($verify->isSuccess()) {
  echo 'Done';
} else {
  echo 'Error: ' . $verify->getErrorMessage();