UPS icon

UPS

Track shipments, validate addresses, rate, and create UPS shipments

Actions4

Shipping → Get Rates

AI-generated

Summary

Retrieve UPS shipping rate quotes including published and negotiated rates along with transit times for a specified shipment.

Inputs

  • Account Number — Optional UPS account number to access negotiated rates; if omitted, the account number in the attached UPS Shipper Profile credential is used.
  • Shipper Address Line 1 — First line of the shipper's address.
  • Shipper Address Line 2 — Second line of the shipper's address.
  • Shipper City — City of the shipper's address.
  • Shipper State / Province Code — State or province code of the shipper's address.
  • Shipper Postal Code — Postal code of the shipper's address.
  • Shipper Country Code — Country code of the shipper's address, defaulting to US.
  • Use a Different Ship-From Address — Boolean flag indicating if the package ships from an address different than the shipper's.
  • Ship From Address Line 1 — First line of the origin address when different from the shipper's address.
  • Ship From Address Line 2 — Second line of the origin address when different from the shipper's address.
  • Ship From City — City of the origin address when different from the shipper's address.
  • Ship From State / Province Code — State or province code of the origin address when different from the shipper's address.
  • Ship From Postal Code — Postal code of the origin address when different from the shipper's address.
  • Ship From Country Code — Country code of the origin address when different from the shipper's address, defaulting to US.
  • Ship To Address Line 1 (required) — First line of the destination address.
  • Ship To Address Line 2 — Second line of the destination address.
  • Ship To City — City of the destination address.
  • Ship To State / Province Code — State or province code of the destination address.
  • Ship To Postal Code — Postal code of the destination address.
  • Ship To Country Code — Country code of the destination address, defaulting to US.
  • Ship To Is Residential — Boolean indicating if the destination address is a residential address.
  • Weight (required) — Package weight; must be zero or greater.
  • Weight Unit — Unit of weight measurement: Pounds (LBS) or Kilograms (KGS).
  • Dimensions — Optional package dimensions including length, width, and height.
  • Dimension Unit — Unit of dimension measurement: Inches (IN) or Centimeters (CM).
  • Is International Shipment — Boolean indicating if the shipment crosses international borders; reveals customs fields when true.
  • Customs Value — Declared customs value of goods; required if shipment is international.
  • Customs Currency — ISO 4217 currency code for customs value.

Output shape

a list of rate quote objects, each including service codes, names, published and negotiated rates, billing weight, transit days, guaranteed delivery times, and any related alerts.

If the origin and destination countries differ, a customs value must be provided. The operation returns all available UPS service options with pricing and transit details, including a warning alert if no negotiated rates are returned. Errors from UPS are mapped and thrown as node errors with detailed messages.

Examples

Example 1: Get UPS shipping rate quotes with address and package details

Fill required shipment origin, destination, weight, and optionally negotiated account number to receive rate quotes.

Links

Discussion