Alert: Effective November 29, 2024, international mail service to Canada is temporarily suspended, due to the strike of the Canadian Union of Postal Workers. 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 2024 Release Notes - PDF
  • Web Tools Label API Migration Guide - PDF
  • Web Tools Label API Mapping Guide - XLSX
  • Web Tools Notice: Account Duration - 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 - PDF
  • Web Tools FAQs - PDF

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 - PDF | HTM
  • Scan Form - PDF | HTM
  • USPS Returns 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
  • Sunday Holiday Availability - PDF | HTM

Facility APIs

  • Post Office Locations API - PDF | HTM
  • Hold for Pickup Facilities Lookup API - PDF | HTM
  • Parcel Locker 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
  • 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 2024 Release Notes (v1.21 updated 10/16/2024) - PDF
  • Web Tools 2024 Release Notes (v1.19 updated 9/20/2024) - PDF
  • Web Tools 2024 Release Notes (v1.17 updated 8/12/2024) - PDF
  • Web Tools 2024 Release Notes (v1.15 updated 7/9/2024) - PDF
  • Web Tools 2024 Release Notes (v1.13 updated 6/18/2024) - PDF
  • Web Tools 2024 Release Notes (v1.11 updated 5/20/2024) - PDF
  • Web Tools 2024 Release Notes (v1.9 updated 5/15/2024) - PDF
  • Web Tools 2024 Release Notes (v1.7 updated 4/11/2024) - PDF
  • Web Tools 2024 Release Notes (v1.5 updated 3/19/2024) - PDF
  • Web Tools 2024 Release Notes (v1.3 updated 2/8/2024) - PDF
  • Web Tools 2024 Release Notes (v1.1 updated 12/8/2023) - PDF
  • Web Tools 2023 Release Notes (v1.27 updated 11/2/2023) - PDF
  • Web Tools 2023 Release Notes (v1.25 updated 10/16/2023) - PDF
  • Web Tools 2023 Release Notes (v1.23 updated 9/12/2023) - PDF
  • Web Tools 2023 Release Notes (v1.21 updated 8/17/2023) - PDF
  • Web Tools 2023 Release Notes (v1.17 updated 6/28/2023) - PDF
  • Web Tools 2023 Release Notes (v1.11 updated 5/22/2023) - PDF
  • Web Tools 2023 Release Notes (v1.9 updated 4/21/2023) - PDF
  • Web Tools 2023 Release Notes (v1.7 updated 3/21/2023) - PDF
  • Web Tools 2023 Release Notes (v1.5 updated 2/16/2023) - PDF
  • Web Tools 2023 Release Notes (v1.3 updated 1/19/2023) - PDF
  • Web Tools 2023 Release Notes (v1.1 updated 1/09/2023) - PDF
  • Web Tools 2022 Release Notes (v1.33 updated 11/03/2022) - PDF
  • Web Tools 2022 Release Notes (v1.31 updated 10/27/2022) - PDF
  • Web Tools 2022 Release Notes (v1.29 updated 10/18/2022) - PDF
  • Web Tools 2022 Release Notes (v1.27 updated 9/28/2022) - PDF
  • Web Tools 2022 Release Notes (v1.25 updated 9/19/2022) - PDF
  • Web Tools 2022 Release Notes (v1.23 updated 9/7/2022) - PDF
  • Web Tools 2022 Release Notes (v1.21 updated 8/9/2022) - PDF
  • Web Tools 2022 Release Notes (v1.19 updated 8/2/2022) - PDF
  • Web Tools 2022 Release Notes (v1.17 updated 7/11/2022) - PDF
  • Web Tools 2022 Release Notes (v1.15 updated 6/24/2022) - PDF
  • Web Tools 2022 Release Notes (v1.13 updated 6/17/2022) - PDF
  • Web Tools 2022 Release Notes (v1.11 updated 6/8/2022) - PDF
  • Web Tools 2022 Release Notes (v1.9 updated 5/4/2022) - PDF
  • Web Tools 2022 Release Notes (v1.7 updated 4/13/2022) - PDF
  • Web Tools 2022 Release Notes (v1.5 updated 3/10/2022) - PDF
  • Web Tools 2022 Release Notes (v1.3 updated 2/2/2022) - PDF
  • Web Tools 2022 Release Notes (v1.1 updated 12/22/2021) - PDF
  • Web Tools 2021 Release Notes (v1.25 updated 11/1/2021) - PDF
  • Web Tools 2021 Release Notes (v1.23 updated 10/19/2021) - PDF
  • Web Tools 2021 Release Notes (v1.21 updated 9/20/2021) - PDF
  • Web Tools 2021 Release Notes (v1.19 updated 9/15/2021) - PDF
  • Web Tools 2021 Release Notes (v1.17 updated 8/10/2021) - PDF
  • Web Tools 2021 Release Notes (v1.15 updated 7/30/2021) - PDF
  • Web Tools 2021 Release Notes (v1.13 updated 6/24/2021) - PDF
  • Web Tools 2021 Release Notes (v1.11 updated 6/14/2021) - PDF
  • Web Tools 2021 Release Notes (v1.9 updated 5/12/2021) - PDF
  • Web Tools 2021 Release Notes (v1.7 updated 4/12/2021) - PDF
  • Web Tools 2021 Release Notes (v1.5 updated 3/8/2021) - PDF
  • Web Tools 2021 Release Notes (v1.3 updated 2/3/2021) - PDF
  • Web Tools 2021 Release Notes (v1.1 updated 1/11/2021) - PDF
  • Web Tools 2020 Release Notes (v1.17 updated 10/13/2020) - PDF
  • Web Tools 2020 Release Notes (v1.13 updated 9/24/2020) - PDF
  • Web Tools 2020 Release Notes (v1.11 updated 9/14/2020) - PDF
  • Web Tools 2020 Release Notes (v1.9 updated 8/10/2020) - PDF
  • Web Tools 2020 Release Notes (v1.7 updated 6/15/2020) - PDF
  • Web Tools 2020 Release Notes (v1.5 updated 5/11/2020) - PDF
  • Web Tools 2020 Release Notes (v1.3 updated 2/13/2020) - PDF
  • 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