File a UPS claim for a lost or damaged package via the UPS Claims API with correct windows per claim type

Steps

1. 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.
2. 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.
3. 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.
4. 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).
5. If additional documentation is requested, upload it within the timeframe specified in the status response to avoid claim closure.
6. Reconcile approved payment against the declared shipment value; UPS pays the lesser of declared value or repair/replacement cost.