Web Tools APIs | USPS (2024)

Web Tools APIs | USPS (1)

Free Ecommerce Website Shipping & Shopping Cart APIs

The USPS Web Tools® API library gives ecommerce website shopping carts and shipping software access to valuable USPS® data—free of charge! You can check shipping rates, track packages, and schedule a package pickup all through USPS Web Tools. Get started now or read on to learn more.

Register Now

Web Tools APIs | USPS (2)

Alert: On June 20, 2024, the USPS Web Tools APIs will be unavailable at 9PM ET for approximately 15 minutes due to routine maintenance.


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)

Updated documentation is now available (Updated 5/16/2024).

ExpressMail to ExpressMailCommitment API Transition Guide - HTM | PDF

New label API restrictions:

  • Label API Restrictions Notice - PDF
  • Label API Restrictions FAQs - PDF
  • Customer Options – Postage Labels - PDF

Quick Links

  • API Technical Documents
  • Shipper Support Center
  • Developer FAQs
  • Shipper FAQs
  • Contact Us

New USPS Developer Portal

New APIs available in the USPS Developer Portal give you more API customization, product offerings, and payment options. Plus, get increased security via OAuth2 tokens, Webhooks push notifications, and embeddable widgets. Learn More

Get Email Updates

Receive email notifications about Web Tools maintenance updates.

Subscribe Now


Start making live calls to Web Tools APIs and integrate with USPS Web Tools to make shipping easier for you and your clients. See available API technical documentation and helpful tips.

Learn More about Web tools for developers


Register to get access to the USPS Web Tools support center and documentation. Plus, find experts to help you with Web Tools integration.

Learn More about Web tools for shippers

Developer Center

Step 1: Sign Up

Complete the online registration form for access. Please note registration is required for Web Tools access and is separate from any other USPS.com credentials.

Register Now

Once registered, you’ll receive an email with your assigned Web Tools User ID. You’ll then have access to our most popular offerings like the price calculator and address validation/standardization APIs. For access to more secure APIs, like Label Printing, you’ll need to request additional permissions in Step 3.

Step 2: View Documentation

Explore API Technical Docs and use the Quick Code provided below to test in your favorite browser.

For developers integrating Web Tools into a custom application, we specifically recommend:

  • Step-by-Step Instructions for All USPS Web Tools (important information when getting started)
  • API User Guides (API–specific technical/integration information)

Step 3: Integrate and Request Additional Permissions

Integrate with USPS Web Tools to start making live calls to Web Tools APIs and make shipping easier for you and your clients.

For access to more secure APIs, like Label Printing, you’ll need additional permissions. Contact the Internet Customer Care Center with the following information:

  • "Web Tools API Access" in the subject line of the email
  • Which APIs you want to access beyond those provided automatically
  • If you'll be modifying the label image

Need more help? View FAQs

Get Started with Price Calculator

Try the Domestic or International Postage Rate APIs first or jump right into the technical documentation and start developing.

Explore Web Tools Right from Your Browser's Search Bar

Once you have completed registration, explore the most popular Web Tools APIs and make live calls to Web Tools® right from your browser. To make live calls:

  1. Open a new .txt or word .doc and copy and paste the User ID from the email you received from registration@shippingapis.com. Keep it on hand for the following steps.
  2. Insert your Web Tools user ID into the USERID="" value
  3. Insert today's date into the value of the "ShipDate" tag (if applicable)
  4. Select the entire XML code below and paste it into the search bar of your browser
  5. Hit enter to make the call and receive a response in your browser
  6. Experiment with Web Tools and change some of the values of the XML tags

Try the Domestic Rate Calculator

Calculate postage rates quickly and easily online for domestic and international shipping. Try the Domestic Rate API below or jump into the technical documentation and start developing.

View Technical Document

Test XML Request

https://secure.shippingapis.com/shippingapi.dll?API=RateV4&XML=<RateV4Request USERID="XXXXXXXXXXXX">


<Package ID="1ST">





Try the International Price Calculator

The International Rate API calculates international postage rates quickly and easily. Try it out below or jump into the technical documentation and start developing.

View Technical Document

Test XML Request

https://secure.shippingapis.com/shippingapi.dll?API=IntlRateV2&XML=<IntlRateV2Request USERID="XXXXXXXXXXXX">


<Package ID="1ST">





Verify an Address

Save time and money by reducing shipping errors due to incorrect address entry. This tool corrects errors in street addresses, including abbreviations and missing information. It also supplies a ZIP+4® Code.

View Technical Document

Test XML Request

Address Validation

https://secure.shippingapis.com/ShippingAPI.dll?API=Verify&XML=<AddressValidateRequest USERID="XXXXXXXXXXXX">


<Address2>6406 IVY LANE</Address2>



ZIP Code Lookup

https://secure.shippingapis.com/ShippingAPI.dll?API=ZipCodeLookup&XML=<ZipCodeLookupRequest USERID="XXXXXXXXXXXX">


<Address2>6406 IVY LANE</Address2>



City/State Lookup

https://secure.shippingapis.com/ShippingAPI.dll?API=CityStateLookup&XML=<CityStateLookupRequest USERID="XXXXXXXXXXXX">

<ZipCode ID="0">




Track a Package

Get estimated delivery information and track any package shipped via Priority Mail Express®, Global Express Guaranteed®, or Priority Mail Express International® services. Check the tracking information for packages shipped with USPS Tracking®, Signature Confirmation, Certified Mail®, or Registered Mail® services.

View Technical Document

Test XML Request

https://secure.shippingapis.com/shippingapi.dll?API=TrackV2&XML=<TrackRequest USERID="XXXXXXXXXXXX">



Look Up Delivery Dates

Get estimated and guaranteed delivery dates with Service Standards and Commitments APIs.

Test XML Request

Priority Mail® Service Standards

https://secure.shippingapis.com/ShippingAPI.dll?API=PriorityMail&XML=<PriorityMailRequest USERID="XXXXXXXXXXXX">


View Technical Document

First-Class Mail® Service Standards

https://secure.shippingapis.com/ShippingAPI.dll?API=FirstClassMail&XML=<FirstClassMailRequest USERID="XXXXXXXXXXXX">


View Technical Document

Priority Mail Express® Service Commitments

https://secure.shippingapis.com/ShippingAPI.dll?API=ExpressmailCommitment&XML=<ExpressMailCommitmentRequest USERID="XXXXXXXXXXXX">


View Technical Document

Service Delivery Calculator

https://secure.shippingapis.com/ShippingAPI.dll?API=SDCGetLocations&XML=<SDCGetLocationsRequest USERID="XXXXXXXXXXXX">


View Technical Document

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?

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.

Shipper Support Center

USPS Web Tools are ecommerce application program interfaces (APIs) that can be used for online stores or customer service centers—free of charge.

Ecommerce Website Support

Get access to our Web Tools through a simple registration process. View FAQs

Register Now

Once registered, you’ll receive an email with your assigned Web Tools User ID. You’ll then have access to the most popular APIs. For access to more secure APIs, like Label Printing, you’ll need additional permissions. Contact the Internet Customer Care Center with the following information:

  • "Web Tools API Access" in the subject line of the email
  • The software vendor you are using
  • Which APIs you want to access beyond those provided automatically

Want to hire a professional?

To assist companies that need help integrating USPS Web Tools into their sites, the Postal Service publishes contact information for some companies willing to provide services that meet our criteria. These lists are not exhaustive and being listed is not an endorsem*nt by USPS.

USPS Web Tools Integrators

Some companies that may be able to assist with the integration of USPS Web Tools or help you build a customer solution using Web Tools ecommerce APIs.
View List of Integrators (PDF)

USPS Web Tools Product Providers

Some companies that sell products with Web Tools already integrated.
View List of Product Providers (PDF)

Expand Allor close all content topics for immediately following heading

Shippers: Web Tools FAQs

Open or Close content below Why are my Web Tools credentials not working when I try to login on USPS.com?

The login page on USPS.com® is not related to APIs. There is no "log in" functionality for your Web Tools credentials. Your username and password will allow you to gain access to the Web Tools servers.

Use your credentials to:

  • Log into the interface of your third-party software
  • Add authentication to your back-end programming in the API, XML

The login page shown on the usps.com website is not associated to APIs. Please review the technical documentation if you need more information about integration.

Open or Close content below Why are the production server URLs I received not working when I click on them?

The production URLs included in the email confirming your registration with Web Tools are not links to a viewable website. These URLs must be included in the XML Request used to connect to our APIs (please refer to our technical documentation) for more information. If you are using a third party ecommerce software, it’s possible that these URLs are not required, and therefore, do not apply to all customers using our APIs. Please contact your software provider for more specific details concerning integration requirements.

Open or Close content below I am using a third-party ecommerce software to connect to USPS APIs, and I am having issues retrieving prices or services from USPS.

Since USPS® does not know every specific integration requirements of all the possible software options available, we recommend that customers first contact their provider to troubleshoot integration-specific questions.

Open or Close content below I have contacted my software provider, and I still have questions for USPS. How do I proceed?

We will be happy to assist all customers provided the following information is included when you contact the Internet Customer Care Center.

Customers must provide:

  • Copy of a sample XML request resulting in the issue or error, pasted into the body of the email
  • Complete description of exact issue you are experiencing
  • Name of API
  • Name of third party software provider

Please note that without the above information, our USPS® agents will not have sufficient information to investigate Web Tools API issues properly.

Contact Us

If you have technical questions or need more information, contact the Internet Customer Care Center (ICCC).

Hours of Operation

Monday–Friday: 8 AM–8:30 PM ET
Saturday: 8 AM–6PM ET
Closed: Sunday and Postal Holidays
Open Holidays: 9 AM–6 PM ET

  • Martin Luther King Jr. Day
  • Presidents' Day
  • Columbus Day
  • Veterans Day

Contact Information

Email Internet Customer Care Center
Call: 1-800-344-7779

'); 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('

');$('.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' ); }

Web Tools APIs | USPS (2024)


Top Articles
Latest Posts
Article information

Author: Errol Quitzon

Last Updated:

Views: 6325

Rating: 4.9 / 5 (59 voted)

Reviews: 82% of readers found this page helpful

Author information

Name: Errol Quitzon

Birthday: 1993-04-02

Address: 70604 Haley Lane, Port Weldonside, TN 99233-0942

Phone: +9665282866296

Job: Product Retail Agent

Hobby: Computer programming, Horseback riding, Hooping, Dance, Ice skating, Backpacking, Rafting

Introduction: My name is Errol Quitzon, I am a fair, cute, fancy, clean, attractive, sparkling, kind person who loves writing and wants to share my knowledge and understanding with you.