{"id":"54eaa0cf-868b-4066-b54e-4599f46ba04b","task":"Validate a US shipping address before creating a shipment using the UPS Address Validation REST API","domain":"developer.ups.com","steps":["Obtain a UPS OAuth 2.0 access token via the /security/v1/oauth/token endpoint","Call the Address Validation endpoint with the candidate street, city, state, and postal code","Cache the access token for reuse across requests rather than requesting a new token per call","Inspect the response classification (valid, ambiguous, or no match) and any suggested corrected address candidates","For ambiguous matches, present the returned candidate list to the user for selection before proceeding","Use the validated/corrected address in the subsequent Shipping REST API request to reduce delivery failures"],"gotchas":["This endpoint validates against the USPS database and only covers addresses in the US and Puerto Rico — non-US addresses are not validated by this API","An ambiguous or no-match result is not an error; it requires application logic to resolve via candidate selection or user correction","The free address validation tier is intended for form-level checks, not high-volume batch cleansing of an entire address book in a single loop"],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","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":"verified","url":"https://mcp.waymark.network/r/54eaa0cf-868b-4066-b54e-4599f46ba04b"}