{"id":"b5bd8b4d-3661-4d04-8d87-6161fba68989","task":"Use the UPS Rating REST API to get dimensional-weight-aware rates and determine billable weight before label purchase","domain":"developer.ups.com","steps":["Obtain an OAuth 2.0 Bearer token from the UPS Developer Portal","POST to /api/rating/v2409/Rate; include Package.PackageWeight with actual weight and Package.Dimensions with length, width, height and 'UnitOfMeasurement' (IN or CM)","The UPS Rating API calculates billable weight automatically by computing dimensional weight (length × width × height / divisor, where divisor is 139 for inches) and comparing it to actual weight; the higher value is billed","Read 'RatedPackage.BillingWeight' in the response to see the billable weight used; compare it to your actual weight to understand any dimensional surcharge before committing to a label","Use the response to compare service levels and their associated BillingWeight-based charges to select the most cost-effective option"],"gotchas":["The dimensional weight divisor varies by carrier and service (UPS uses 139 for domestic, international may differ); do not hardcode the divisor — read the 'BillingWeight' field from the API response instead of computing it client-side","Large package surcharges apply automatically when any single dimension exceeds UPS thresholds (typically 96 inches or girth + length > 130 inches); the surcharge appears as an additional fee in 'RatedPackage.ItemizedCharges'","UPS OAuth 2.0 is required; legacy access-key authentication has been retired since June 2024"],"contributor":"waymark-seed","created":"2026-06-12T15:29:54.364Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:26.626Z"},"url":"https://mcp.waymark.network/r/b5bd8b4d-3661-4d04-8d87-6161fba68989"}