UPS icon

UPS

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

Actions4

Address → Validate

AI-generated

Summary

Validate and classify a physical address by sending its components to the UPS Address Validation API, returning resolution status, classification (residential/commercial), and suggested candidate addresses.

Inputs

  • addressLine1 (required) — Street address line 1, required for validation.
  • addressLine2 — Optional street address line 2.
  • city — City name of the address.
  • stateProvinceCode — Two-letter state or province code (e.g., NY).
  • postalCode — Postal or ZIP code; ZIP+4 values are automatically split.
  • countryCode — Two-letter country code, defaulting to 'US'.

Output shape

a single item containing a JSON object with resolution, classification, and candidate addresses

The output JSON includes the resolution status ('valid', 'ambiguous', or 'none'), address classification (with code and label e.g. residential or commercial), and an array of candidate addresses if available.

Links

Discussion