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

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.

The Service Standards Directory provides a secure and efficient way to return service standard data for 3 or 5-digit ZIP Codes. Utilize the /zip5codes and /reporter endpoints to return paginated Service Standards data.

The Service Standards File Download API provides an efficient way for mailers to download Service Standards files so they can be consumed programmatically and not require manual intervention.

The Ship Enrollment API allows a user to check if their MID is enrolled in USPS Ship. If enrolled, the enrolled programs (such as Outbound and Returns) and the date the MID was enrolled will be returned in the response.