Pre-Notification API

Avoid delays of your dangerous goods shipments

Dangerous goods package

The Pre-Notification API allows customer applications to inform UPS operations of dangerous goods shipments that have been processed and will enter the UPS transportation network prior to an upload of manifest information at the end of the day. This will assist in improved handling and fewer delays for dangerous goods shipments. The Pre-Notification API can be used in conjunction with other APIs after a dangerous goods shipment has been processed.

Finally, the use of this API will be required for customers who have a dangerous goods contract and are shipping cargo quantities of dangerous goods or are shipping dangerous goods via road transport in Europe (European Agreement Concerning the International Carriage of Dangerous Goods by Road or ADR).

Functionality includes:

  • Notify UPS of dangerous goods shipments once the shipment is processed.
  • Notify UPS of voided dangerous goods shipments.

In addition, custom code that adapts your application's business logic and data to the API must be developed in order to integrate this API's functionality into your business systems.

Prior to downloading this API you should be familiar with:

  • Programming URL or socket connections
  • Encoding and decoding XML documents
  • Designing and implementing a strategy into your existing software for handling errors

Available version(s): Web Service, JSON

Available mode(s): Package

To help you effectively integrate Pre-Notification, the following guide and reference materials are included with the API:

  • Developer's Guide (with technical FAQs)
  • UPS logos and banners

Code samples:

  • DOTNET in C# (supported only for web service)
  • Java
  • Perl
  • PHP
  • XML

Download the API

You must Log in to download the API documentation.


(32 countries or territories) Austria, Belgium, Canada, Czech Republic, Denmark, Dominican Republic, Finland, France, Germany, Greece, Hong Kong, Hungary, Ireland, Italy, Japan, Luxembourg, Malaysia, Netherlands, Norway, Philippines, Poland, Portugal, Puerto Rico, Singapore, South Korea, Spain, Sweden, Switzerland, Taiwan, Turkey, United Kingdom and United States

Developer Resource Center

Developers: Download APIs

Stay informed. Sign up for our emails.
Subscribe to UPS emails.

Email Examples

Sign up for email offers, insights, and industry news that can help improve your shipping. You can manage your preferences at any time.

News and Insights to help you ship smarter

Service Updates to alert you to severe weather and events impacting operations

Promotions and Offers to help you get the most for your money

Product News to keep you up-to-date on new services, tools, and features