Dangerous Goods API

Simplify the process of shipping dangerous goods

Dangerous goods package

The Dangerous Goods API allows applications to validate dangerous goods shipments prior to shipping. The Dangerous Goods API verifies that dangerous goods shipments meet regulation set requirements as well as ensuring they are valid for carriage within the UPS transportation network. Dangerous Goods validation and shipping require a UPS Contract so please check with your UPS Sales Person for available Dangerous Goods services prior to downloading the developer kit.

Functionality includes:

  • Acceptance Audit Pre-check validates a Dangerous Goods shipment is acceptable to UPS. Validations include origin / destination country and postal code, UPS service, regulation set, transportation mode, and chemical record details (quantity, packing group, packing instruction, etc.).
  • The UPS Shipping API has Acceptance Audit Pre-check functionality “built in”, so Dangerous Goods shipments processed on the Shipping API are automatically validated
  • Chemical Reference Data Lookup retrieves Dangerous Goods chemical record details (i.e. allowable packing groups, packing instructions, etc.) based upon UN number or Proper Shipping Name. This functionality complements the Acceptance Audit Pre-check.

Regulation sets supported include:

  • European Agreement Concerning the International Carriage of Dangerous Goods by Road (ADR)
  • International Air Transport Association (IATA)
  • United States - Code of Federal Regulations, Title 49 (49CFR)
  • Canada – Transportation of Dangerous Goods Regulations (TDG)

This API works in conjunction with order entry and manifesting systems. Please note, the Dangerous Goods API is to be used for UPS shipments only.

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 Dangerous Goods, 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.


(31 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, 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