Web Tools Tech Docs | USPS (2024)

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.

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

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?

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

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

'); console.log(k);});$(".vdrawers .expandv").on('touch click',function(e){e.preventDefault();if ($(this).parents('.vdrawers').hasClass('active')){$(this).text('Expand All');$(this).parents('.vdrawers').removeClass('active');$(this).parents('.vdrawers').find('.v-tab div').removeClass('active');console.log('expand active - removing active');} else {$(this).text('Hide All');$(this).parents('.vdrawers').find('.v-tab div').addClass('active');$(this).parents('.vdrawers').addClass('active');console.log("expand not active - adding active");}});$('.vdrawers .v-tab div a').not('sup').on('click touch', function(e){console.log('Clicked on v-tab link');e.preventDefault();if($(window).width()>=767){console.log('desktop:start');$this = $(this).parents('.vdrawers');$this.find('.v-tab div.active').removeClass('active');$this.find('.v-tab-content div.active').removeClass('active');$(this).parent().addClass('active');$this.find('.v-tab-content div').eq($this.find('.v-tab div.active').index()).addClass('active');console.log('desktop:'+$this.html());console.log('desktop:end');$('html, body').animate({scrollTop: $(this).parents('.vdrawers').find('.v-tab-content div').eq($('.v-tab div.active').index()).offset().top}, 500);} else if ($(window).width()<767) {if ($(this).parent().hasClass('active')){$(this).parent().removeClass('active');$('html, body').animate({scrollTop: $(this).parent().offset().top}, 500);} else {$(this).parents('.vdrawers').find('.v-tab div.active').removeClass('active');$(this).parent().addClass('active');$('html, body').animate({scrollTop: $(this).parent().offset().top}, 500);}}});$('.lg-crd h3').not('sup').on('click touch', function(e){console.log('Clicked on faq');e.preventDefault();$(this).parent().parent().toggleClass('active');});$('a.expand').on('click touch', function(e){e.preventDefault();$this = $(this);$this.toggleClass('active');if ($this.hasClass('active')){$this.text('Hide All');$this.parents('.faq-section, .lg-txt-crd,.visible-expand').find('.lg-crd, .faq-unit,.expand-unit').addClass('active');}else{$this.text('Expand All');$this.parents('.faq-section, .lg-txt-crd,.visible-expand').find('.lg-crd, .faq-unit,.expand-unit').removeClass('active');}});//$('').append('...less');/*$('.expand-less, .expand-more').on('click touch', function(e){e.preventDefault();$(this).parents('.expand-unit').toggleClass('active');});*/$('.faq-unit>*:first-child,.expand-unit>*:first-child').not('sup').on('click touch', function(e){console.log('Clicked on faq');e.preventDefault();$(this).parent().toggleClass('active');});$('.expand-all').on('click touch', function(e){console.log('Expand all function')$this = $(this);$this.toggleClass('active');if ($this.hasClass('active')){$this.text('Hide All');$this.parents('.visible-expand').find('.expand-unit').addClass('active');}else{$this.text('Expand All');$this.parents('.visible-expand').find('.expand-unit').removeClass('active');}});$.each( $('.expand-unit > p:first-of-type'), function(i){g = $(this).parent('.expand-unit').find('h4').eq(0).text();console.log(g) $(this).append(' Show More '+g+''); });$('.expand-unit .drawer:last-child').append('

Show Less

');$('.expand-less, .expand-more').on('click touch', function(e){e.preventDefault();$(this).parents('.expand-unit').toggleClass('active');$('html, body').animate({scrollTop: $(this).parents('.expand-unit').offset().top}, 500);});});function addEmail() {window.open( 'http://oi.vresp.com?fid=ac5986480c', 'vr_optin_popup', 'scrollbars=yes,width=600,height=300' ); }