APIs

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 provides service standard messages for International mailings based on destination country code and mail class. Service standards are not necessarily the same as the actual service performance.

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.

The Logistic Shipments API enables third-party logistics partners to submit real-time shipment tracking events to USPS. Using GPS data, it keeps USPS informed of a trailer's location, milestone status, and estimated arrival as it travels to or from USPS facilities and customer locations. Each event links the partners internal load number to a USPS FAST appointment ID — giving drivers, customers, and USPS a shared view of the shipment throughout its journey, from initial dispatch through final facility arrival.

The NCOA+ API uses a secure dataset built from the names and addresses of individuals, families, and businesses that have submitted a change of address request to the Postal Service™. It allows mailers to process and update mailing lists with the most current addresses before sending mail. Users can also restrict searches to a specific time range. In addition, the API provides address standardization results for both the original and updated addresses.

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.

This API allows for the creation of Priority Mail Open and Distribute (PMOD) and Priority Mail Express Open and Distribute (PMEOD) labels and containers.  The Open and Distribute service is an option for mailers to bundle their shipments into a single package/container which will be opened and sorted at the destination facility.

The API will create the PMOD/PMEOD label and the 99M form required for mailing.  Items can be added to the Open and Distribute container and closed when ready for manifest.

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

The Smart Locker QR Code API allows shippers and integrators to request and retrieve pick up QR codes for packages destined for USPS lockers. This capability enables shippers to enhance the post purchase experience by providing customers with clear, direct pickup instructions.

Access to the API is limited to tracking numbers associated with mailer IDs (MIDs) owned by the requesting integrator or shipper. The API returns a base64 encoded QR code, which must be decoded and rendered as an image before use.

The Reconciliation Adjustments API provides an interface for retrieving USPS shipping adjustments based on a Package Identification Code (PIC), commonly referred to as a tracking number. This API is designed to help users identify and understand discrepancies in shipping charges, such as those caused by weight, dimensions, packaging, or zone miscalculations. By leveraging this API, users can access detailed adjustment data, including root causes, pricing characteristics, and postage adjustments, enabling them to reconcile shipping costs effectively.

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.