| name | ups-cli |
| description | Track UPS shipments and manage shipping using the ups CLI. Use when working with package tracking, shipping labels, rates, or when the user mentions UPS, package tracking, shipping, or ups. |
UPS CLI
Track and manage UPS shipments using the ups command-line tool.
Prerequisites
ups --version
export UPS_API_KEY='your-api-key'
export UPS_USERNAME='your-username'
export UPS_PASSWORD='your-password'
ups auth status
Authentication
- API key, username, and password from UPS Developer Kit
- Environment variables:
UPS_API_KEY, UPS_USERNAME, UPS_PASSWORD
Package Tracking
Track Shipments
ups track TRACKING_NUMBER
ups track TRACKING_NUMBER --details
ups track TRACKING_NUMBER --proof-of-delivery
Batch Tracking
ups track --file tracking-numbers.txt
ups track 1Z999AA10123456784 1Z999AA10234567895 --summary
History
ups history --days 30 --status delivered
ups recent --limit 20
Shipping Rates
ups rates --from "90210" --to "10001" --weight 5lbs
ups rates --from ZIP --to ZIP --weight WEIGHT --dimensions LxWxH --service ground
ups rates compare --from ZIP --to ZIP --weight 10lbs
Shipping Labels
ups label create --from SHIPPER_JSON --to RECIPIENT_JSON --package PACKAGE_JSON
ups label void LABEL_ID --confirm
ups label reprint LABEL_ID
Pickup & Drop-off
ups pickup schedule --date 2024-06-15 --time "14:00-16:00"
ups pickup cancel PICKUP_ID
ups locations --near "90210" --type "UPS Store"
Agent Best Practices
- Tracking numbers: Validate format before querying
- Rate shopping: Use
compare for best service/price
- Address validation: Use
--validate before creating labels
- Reference numbers: Use for internal tracking
