Alert: USPS is following strategies and measures recommended by the CDC and Public Health Departments. Read more ›

Web Tools 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 the Internet Customer Care Center.

Developer Guides & Instructions
Step-by-Step Instructions for All USPS Web Tools (HTM | PDF)

Announcements & Upcoming Release Notes

  • Web Tools 2020 Release Notes - PDF
  • Web Tools Notice: TLS 1.2 Protocol Compliance - PDF
  • ExpressMail to ExpressMailCommitment API Transition Guide - HTM | PDF
  • Label API Restrictions Notice - PDF
  • Label API Restrictions FAQs - PDF
  • Customer Options – Postage Labels - PDF
  • New: Simplified Onboarding Process - RTF
  • Web Tools FAQs - RTF

Show Past Release Notes

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
  • Tracking 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

Open or Close content below Are the USPS APIs free?

Customers who have registered for a USPS Web Tools® account and agreed to the terms and conditions of use can access USPS APIs for free.

Open or Close content below How do I get access to USPS APIs and receive my user ID?

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
  • Package Pickup

Open or Close content below The labels I am able to print contain a “SAMPLE-DO NOT MAIL” watermark. How can I print actual labels?

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.

Open or Close content below Does USPS have an EDDM API available?

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

Go to EDDM

Open or Close content below Have there been any recent or upcoming changes to Web Tools API?

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 Notes. This 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.

Past Release Notes

  • Web Tools 2020 Release Notes (v1.1 updated 1/9/2020) - PDF
  • Web Tools 2019 Release Notes (v1.11 updated 10/21/2019 - PDF
  • Web Tools 2019 Release Notes (v1.9 updated 9/24/2019) - PDF
  • Web Tools 2019 Release Notes (v1.7 updated 7/27/2019) - PDF
  • Web Tools 2019 Release Notes (v1.5 updated 4/24/2019) - PDF
  • Web Tools 2019 Release Notes (v1.3 updated 2/21/2019) - PDF
  • Web Tools 2019 Release Notes (v1.1 updated 12/31/2018) - PDF
  • Web Tools 2018 Release Notes (v1.19 updated 9/19/2018) - PDF
  • Web Tools 2018 Release Notes (v1.17 updated 8/7/2018) - PDF
  • Web Tools 2018 Release Notes (v1.15 updated 7/23/2018) - PDF
  • Web Tools 2018 Release Notes (v1.13 updated 6/22/2018) - PDF
  • Web Tools 2018 Release Notes (v1.9 updated 5/9/2018) - PDF
  • Web Tools 2018 Release Notes (v1.7 updated 3/22/2018) - PDF
  • 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
  • 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