Skip all category navigation links
hamburger menu Icon Search Icon

Top Searches

 

Web Tools Documentation & Updates

Migrate NOW to USPS APIs

The USPS Web Tools API platform was retired on January 25, 2026 and service disruptions are underway. Platform support is sunsetting and availability may be degraded or interrupted at any time. To avoid service disruptions, migrate now to the new USPS APIs.

The functional equivalents of the Web Tools APIs are now available in the USPS API Catalog: USPS APIs Developer Portal.

Sign Up for USPS APIs

The full Web Tools API platform is retired as of January 25, 2026. To avoid any service disruptions, migrate to the new USPS APIs. Contact USPS API Support for help and provide any feedback via the feedback form.

Announcements & Upcoming Release Notes

  • Web Tools 2026 Release Notes - PDF
  • How to Transition to USPS APIs - PDF
  • FAQs - Web Tools to USPS APIs - PDF
  • USPS APIs Migration Onboarding Guide PDF
  • USPS APIs - Web Tools Mappings
    • USPS Address API - Web Tools Mapping - XLSX
    • USPS Carrier Pickup API - Web Tools Mapping - XLSX
    • USPS Domestic Label API - Web Tools Mapping - XLSX
    • USPS International Label API - Web Tools Mapping - XLSX
    • USPS SCAN Form API - Web Tools Mapping - XLSX
    • USPS Tracking API - Web Tools Mapping - XLSX
    • USPS Price API - Web Tools Mapping - XLSX
    • USPS International Price API - Web Tools Mapping - XLSX
    • USPS Shipping Options API - Web Tools Mapping - XLSX
    • USPS Service Standards API - Web Tools Mapping - XLSX
    • USPS Location API - Web Tools Mapping - XLSX
  • Web Tools Notice: Account Duration Update - 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

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

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
Expand Allor close all content topics for immediately following heading

Developers: Web Tools FAQs

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?

Register Now

Once registered, you'll receive an email containing your Web Tools credentials and instructions on how to begin using APIs. Please reference the instructions prior to requesting access and beginning integration.

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 2026 Release Notes (v1.1 updated 12/31/2025) - PDF
  • Web Tools 2025 Release Notes (v1.21 updated 11/7/2025) - PDF
  • Web Tools 2025 Release Notes (v1.19 updated 10/17/2025) - PDF
  • Web Tools 2025 Release Notes (v1.17 updated 9/8/2025) - PDF
  • Web Tools 2025 Release Notes (v1.15 updated 8/21/2025) - PDF
  • Web Tools 2025 Release Notes (v1.13 updated 7/17/2025) - PDF
  • Web Tools 2025 Release Notes (v1.11 updated 6/27/2025) - PDF
  • Web Tools 2025 Release Notes (v1.9 updated 5/15/2025) - PDF
  • Web Tools 2025 Release Notes (v1.7 updated 4/16/2025) - PDF
  • Web Tools 2025 Release Notes (v1.5 updated 3/17/2025) - PDF
  • Web Tools 2025 Release Notes (v1.3 updated 2/11/2025) - PDF
  • Web Tools 2025 Release Notes (v1.1 updated 1/10/2025) - PDF
  • Web Tools 2024 Release Notes (v1.23 updated 11/08/2024) - PDF
  • 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