Alert: As of April 30, USPS.com will no longer support outdated browsers. To continue access, you may need to upgrade your browser. Read more ›

‹ Return to Web Tools API Portal

Documentation & Updates

Use our technical documents to get step-by-step information on how to integrate USPS Web Tools® into a website or shipping application. For technical questions, contact us at uspstechnicalsupport@mailps.custhelp.com.

Get Adobe Acrobat ›

Announcements & Upcoming Release Notes

• Web Tools 2018 Release Notes - PDF
• Label API Restrictions Notice - PDF
• Label API Restrictions FAQs - PDF
• Customer Options – Postage Labels - PDF
• June-November 2017 Release Notes (updated 9/12/2017) - PDF
• March 2017 Release Notes (updated 3/13/2017) - PDF
• January-March 2017 Release Notes (updated 2/14/2017) - PDF
• February 2017 API Retirement Transition Guide (v. 1.3, updated 12/8/2016) - PDF
• New: Simplified Onboarding Process - RTF
• Web Tools FAQs - RTF

Show Past Release Notes about Web Tools™

Past Release Notes

• February and March 2018 Release Notes (v1.5 updated 2/12/2018) - PDF
• January and February 2018 Release Notes (v1.3 updated 1/4/2018) - PDF
• January 2018 Release Notes (v1.1 updated 12/7/2017) - PDF
• USPS Web Tools Secure/HTTPS API Outage - September 17, 2017 - PDF
• August-November Release Notes (v.1.5, updated 10/20/2016) - PDF
• August/September Release Notes (v.1.3, updated 8/24/2016) - PDF
• Spring 2016 Release Notes (updated 5/13/2016) - DOC
• Spring 2016 Release Notes (updated 4/01/2016) - PDF
• Transition Guide: Service Delivery Calculator API - RTF
• Transition Guide: RateV3 to RateV4 - RTF
• February 29, 2016 Release Notes (updated 2/29/2016) - RTF
• January 2016 Release Notes (updated 12/29/2015) - RTF
• September 2015 Release Notes (updated 9/18/2015) - RTF
• July 2015 Release Notes (updated 7/22/2015) - RTF
• Web Tools SSL Security Certificate (updated 6/7/15) - DOC
• May 2015 Release Notes (updated 5/19/2015) - RTF
• Transition Guide: Service Delivery Calculator API - RTF
• January 2015 Release Notes (posted 1/23/2015) - RTF
• September 7th Maintenance Release Notes (v1.5, posted 9/4/14) - RTF
• International Delivery Confirmation Release Notes - RTF
• PMEI Guarantee to Canada Release Notes - RTF
• June 2014 - RTF
• Transition Guide: RateV3 to RateV4 - RTF
• May 2014 - RTF
• March 2014 - RTF
• February 2014 - RTF
• January 2014 - RTF
• July 2013 - RTF
• May 2013 - RTF

Developer Guides & Instructions

Step-by-Step Instructions for All USPS Web Tools - HTM | PDF

API User Guides

Address APIs - PDF | HTM

• Address Validation/Standardization
• City & State Lookup
• Zip Code™ Lookup

Tracking & Delivery Information APIs - PDF | HTM

• Tracking
• Tracking by Email
• Proof of Delivery
• Return Receipt Electronic

Price Calculator APIs - PDF | HTM

• Domestic Price Calculator
• International Price Calculator

Shipping Label APIs

• eVS Domestic Labels - PDF | HTM
• eVS International Labels API - PDF | HTM
• Scan Form - PDF | HTM
• Merchandise Return Service Labels - PDF | HTM
• Merchandise Return Service Bulk Labels - PDF | HTM

Package Pickup APIs - PDF | HTM

• Check pickup availability
• Schedule a pickup
• Cancel a pickup request
• Update a pickup request

Service Standards & Commitments APIs

• Domestic Mail Service Standards - PDF | HTM
• Service Delivery Calculator - PDF | HTM

Hold for Pickup Facilities Lookup API - PDF | HTM

General Web Tools FAQs

Are the USPS APIs free? Expand Collapse FAQ question

Get access to USPS APIs when you register for a Web Tools user account.

Register Now

Once registered, you will automatically receive an email containing your assigned Web Tools User ID. After you receive this email, you can use the following APIs:

  • Price Calculators
  • Package Tracking
  • Service Standards & Commitments
  • Address Information

The API containing "Certify" is our testing API and will print labels with the sample watermark. In order to generate actual labels, you must remove "Certify" from all of your Web Tools XML requests.

We currently only offer Every Door Direct Mail® (EDDM) services through our online application at.

Learn More

In order to provide the very best API offering, we periodically update our systems which may require current customers to update their software. To determine if these changes/updates apply to you, refer to our most recent Release NotesThis document contains all new changes and steps to resolve if you are affected. Please remember to first contact your software provider for any integration-related questions.