APIs

The Addresses API validates and corrects address information, eliminating errors, improving package delivery service and package pricing. This suite of APIs provides different utilities for addressing components. The ZIP Code lookup finds valid ZIP Codes for a City and State.  The City/State lookup provides the valid cities and states for a provided ZIP Code.  The Address Standardization API validates and standardizes USPS domestic addresses, city and state names, and ZIP Codes in accordance with USPS addressing standards.  The USPS address standard includes the ZIP+4, signifying a USPS delivery point, given a street address, a city and a state.

The API supports customers scheduling a carrier to pick up your packages on the next USPS delivery day (Monday through Saturday, excluding holidays) for free. Carrier Pickup is available for sending packages using Priority Mail Express, Priority Mail, First Class Package Service Commercial, international delivery services, or for returned merchandise. You are able check availability, schedule, change, cancel and inquire on a carrier pickup. 

The Domestic Labels API supports creation of domestic shipping labels with Intelligent Mail Package Barcodes (IMpb). Along with label and barcode creation in PDF, TIFF, SVG, JPG, ZPL203DPI, or ZPL300DPI format, this API validates addresses, confirms product availability, calculates postage, and generates the required Shipping Services File in accordance with USPS Publication 199.

The Domestic Labels API allows you to integrate USPS shipping label creation and postage payment fully into your customer-facing or internal fulfillment systems and processes.

Creating a USPS shipping label and barcode – the domestic labels API provides a USPS certified label and barcode that will ensure packages reach their destination and are readable by USPS scanners and package processing machines.

Generating a USPS Shipping Services File – the Shipping Services File is an electronic pre-advice manifest that is required for shipping with the USPS – the labels API takes the package characteristics provided in your request and creates the Shipping Services File on your behalf, ensuring adherence to USPS and customs compliance standards and will avoid penalties and fees related to non-compliance.

This API provides Domestic USPS product pricing based on the characteristics of what is being shipped for Parcel Select, Parcel Select Lightweight, Priority Mail, Priority Mail Express, USPS Ground Advantage, Library Mail, Media Mail, and Bound Printed Matter. Given inputs, such as origin and destination ZIP Codes, package weight and dimensions, processing category, destination rate indicator, price type, and desired Mail Class and Extra Services, this API will return the price of postage. 

The International Labels API supports creation of international shipping labels. Along with label and barcode creation in TIFF and PDF format, this API confirms product availability, calculates postage, and generates the required Shipping Services File in accordance with USPS Publication 199.

The International Labels API allows you to integrate USPS shipping label creation and postage payment fully into your customer-facing or internal fulfillment systems and processes.

Creating a USPS shipping label and barcode – the international labels API provides a USPS certified label and barcode that will ensure packages reach their destination and are readable by USPS scanners and package processing machines. 

Generating a USPS Shipping Services File – the Shipping Services File is an electronic pre-advice manifest that is required for shipping with the USPS – the international labels API takes the package characteristics provided in your request and creates the Shipping Services File on your behalf, ensuring adherence to USPS and customs compliance standards and will avoid penalties and fees related to non-compliance.

The International Prices API provides International USPS product pricing based on the characteristics of what is being shipped for Global Express Guaranteed, Priority Mail Express International, Priority Mail International, and First-Class Package International. Given inputs, such as origin and destination ZIP Codes, package weight and dimensions, processing category, destination rate indicator, price type, and desired Mail Class and Extra Services, this API will return the price of postage and Extra Services.

This API supports returning destination entry facilities (i.e., drop off locations) for a given ZIP Code to enable Parcel Select Destination Entry, USPS Connect, and Parcel Select Lightweight. This API also provides additional information about working hours, delivery type, mail class, shape, palletization, and facility type.

The Drop-Off Locations API enables businesses using USPS Connect products/services to determine the most convenient USPS location at which to drop off their packages and mail.

Your exclusive access to USPS APIs is protected using OAuth 2.0 industry standards.

All USPS APIs require an OAuth 2.0 access token to be conveyed in the 'Authorization' header, using the 'Bearer' token scheme.

Once you sign-in to the API developer portal, you may get the OAuth credentials you will need to register your application 'Add App'. See "Getting Started" for further information about: signing-in, registering your application, and additional USPS account credentials you will need to integrate your application with USPS APIs.

You are responsible for securing the application credentials once issued. Please contact USPS if your credentials have been disclosed to external parties and we will issue new credentials.

The API supports registration of new companies to USPS.  This API will create a new customer registration ID and mailer ID if the customer is not known to USPS.  If USPS has a record of the company, the API will not create a new customer registration ID or mailer ID.  

Caches payment account information so that it is entered once then used to create multiple labels. 

Shipment Confirmation Acceptance Notice(SCAN) form allows integrators to link multiple domestic and international labels through one Electronic File Number (EFN) and physical SCAN Form (PS Form 5630 or 3152). 

This API supports the service standards for the number of days between the acceptance and delivery of a piece of mail that the Postal Service™ considers to be timely delivery. Service standards are delivery benchmarks for how long customers can expect for the Postal Service to deliver different types of mail from origin to destination — Point A to Point B. Service standards are not necessarily the same as the actual service performance.