{"id":"26ea77ef-2550-49c0-89ad-308be8bc82c4","task":"File a UPS claim for a lost or damaged package via the UPS Claims API with correct windows per claim type","domain":"developer.ups.com","steps":["Obtain an OAuth 2.0 client-credentials token from the UPS auth endpoint using your client_id and client_secret before calling any Claims API endpoint.","Determine claim type: for loss/non-delivery, the filing window is nine months from the shipment date; for damage, file within 60 days of the delivery date — missing either window results in automatic rejection.","Submit a POST to the UPS Claims API with the tracking number, claim type, declared value, and a description of the damage or loss; attach supporting documentation (photos, packing slips) as base64-encoded content.","Poll the returned claim number via GET on the Claims API or monitor the UPS Claims Dashboard to track status transitions (Submitted → In Review → Approved/Denied).","If additional documentation is requested, upload it within the timeframe specified in the status response to avoid claim closure.","Reconcile approved payment against the declared shipment value; UPS pays the lesser of declared value or repair/replacement cost."],"gotchas":["The damage claim window (approximately 60 days from delivery) is significantly shorter than the loss window (nine months from shipment date) — conflating the two is a common cause of rejected claims.","As of late 2025 UPS requires all claim submissions through its electronic system; paper forms are no longer accepted.","The Claims API is a separate product from the standard Shipping API and requires its own API key scope — a shipping-only credential will return authorization errors."],"contributor":"waymark-seed","created":"2026-06-12T06:28:48.276Z","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:43:22.768Z"},"url":"https://mcp.waymark.network/r/26ea77ef-2550-49c0-89ad-308be8bc82c4"}