Address Information APIs

Verify your customer’s address before you ship with USPS Web Tools® Address Information APIs.

Register and Get Access to Web Tools APIs

Once you’re registered to use Web Tools APIs, you’ll need to request permission to access Address Information APIs.

Submit a Request Now
Back to Full List of USPS Web Tools®

Address Information APIs

Address Standardization/Verification Expand Collapse FAQ question

Save time and money by reducing shipping errors due to improper address entry. This tool corrects errors in street addresses, including abbreviations and missing information. It also supplies a ZIP+4® Code.

View Technical Document

Test XML Request

http://production.shippingapis.com/ShippingAPITest.dll?API=Verify&XML=<AddressValidateRequest%20USERID="xxxxxxxxxxxx">

<Address>
<Address1></Address1>
<Address2>6406 Ivy Lane</Address2>
<City>Greenbelt</City>
<State>MD</State>
<Zip5></Zip5>
<Zip4></Zip4>
</Address>

</AddressValidateRequest>

Test XML Response

<?xml version="1.0"?>
<AddressValidateResponse>

<AddressID="0">
<Address2>6406 IVY LN</Address2>
<City>GREENBELT</City>
<State>MD</State>
<Zip5>20770</Zip5>
<Zip4>1440</Zip4>
</Address>

</AddressValidateResponse>

Never get another ZIP Code wrong again with the ZIP Code Lookup tool. Find matching ZIP Codes or ZIP+4 Codes for any given address, city, and state in the U.S.

View Technical Document

Never get another ZIP Code wrong again with the ZIP Code Lookup tool. Find matching ZIP Codes or ZIP+4 Codes for any given address, city, and state in the U.S.

View Technical Document

Test XML Request

http://production.shippingapis.com/ShippingAPITest.dll?API=ZipCodeLookup&XML=
<ZipCodeLookupRequest%20USERID="xxxxxxxxxxxx">


<Address1></Address1>
<Address2>6406 Ivy Lane</Address2>
<City>Greenbelt</City>
<State> MD</State>

</ZipCodeLookupRequest>

Test XML Response

<?xml version="1.0"?>
<ZipCodeLookupResponse>


<AddressID="0">
<Address2>6406 IVY LN</Address2>
<City>GREENBELT</City>
<State>MD</State>
<Zip5>20770</Zip5>
<Zip4>1440</Zip4>

</ZipCodeLookupResponse>

Don’t waste time searching for a city or state; use a ZIP Code to get accurate city and state information automatically.

View Technical Document

Test XML Request

http://production.shippingapis.com/ShippingAPITest.dll?API=CityStateLookup&XML=<CityStateLookupRequest%20USERID="xxxxxxxxxxxx">

<ZipCode ID= "0">
<Zip5>90210</Zip5>
</ZipCode>
</CityStateLookupRequest>

Test XML Response

<?xml version="1.0"?>
<CityStateLookupResponse>

<ZipCode ID="0">
<Zip5>90210</Zip5>
<City>BEVERLY HILLS</City>
<State>CA</State>
</ZipCode>
</CityStateLookupResponse>

Need pickup times and destination information? This tool provides all USPS® facilities that offer Hold For Pickup service within the destination area.

View Technical Document

Sample XML Request

http://SERVER/PATH?API=HFPFacilityInfo&XML=<HFPFacilityInfoRequest USERID="xxxxxxxxxxxx">

<PickupCity/>
<PickupState/>
<PickupZIP>33952</PickupZIP>
<PickupZIP4 />
<Service />
</HFPFacilityInfoRequest>

Sample XML Response

<?xml version="1.0" encoding="UTF-8"?>
<HFPFacilityInfoResponse>

<PickupCity/>
<PickupState/>
<PickupZIP>33952</PickupZIP>
<PickupZIP4/>
<Facility>
<FacilityID>1438805</FacilityID>
<FacilityName>PORT CHARLOTTE</FacilityName>
<FacilityAddress>3740 TAMIAMI TRL</FacilityAddress>
<FacilityCity>PORT CHARLOTTE</FacilityCity>
<FacilityState>FL</FacilityState>
<FacilityZIP>33952</FacilityZIP>
<FacilityZIP4>9998</FacilityZIP4>
<Has10amCommitment>false</Has10amCommitment>
</Facility>
<Facility>
<FacilityID>1378061</FacilityID>
<FacilityName>PORT CHARLOTTE ANNEX</FacilityName>
<FacilityAddress>18100 PAULSON DR</FacilityAddress>
<FacilityCity>PORT CHARLOTTE</FacilityCity>
<FacilityState>FL</FacilityState>
<FacilityZIP>33954</FacilityZIP>
<FacilityZIP4>9998</FacilityZIP4>
<Has10amCommitment>false</Has10amCommitment>
</Facility>
</HFPFacilityInfoResponse>