Insurance Guide

This guide will teach you how to insure your EasyPost packages. In this example, we will be insuring an item worth $249.99.

When insuring a shipment, you go through the same steps as shipping a package that is not insured, except that you need to add insurance to your shipment. If you don't know how to create a shipment, we recommend completeing our Getting Started Guide before starting our Shipping Insurance Guide.

Step 1: Adding Insurance to a Shipment

It's really simple. After you have created a shipment and purchased your postage, you just have to use our "insure" method to purchase insurance. Pass through the dollar value of the contents of the package using the amount parameter of the insure method.

To start a claim, simply email us a completed claims form along with a handful of key documents that are listed on the form. You’ll receive reimbursement within 10 days. No more waiting periods, hassle or extensive forms.

For insurance related inquiries, email us at insurance@easypost.com.

We process claims within 48 hours of receiving all relevant documentation and payments are made within 10 business days. And unlike most insurance plans, we offer international coverage to virtually every country in the world.

      
curl https://api.easypost.com/v2/shipments/shp_1234/insure \
  -u <YOUR_TEST/PRODUCTION_API_KEY>: \
  -d 'amount=249.99'

      
    

{
  "id": "shp_...",
  "object": "Shipment",
  "mode": "test",
  "insurance": "249.99",
  "to_address": {
    "id": "adr_...",
    ...
  },
  "from_address": {
    "id": "adr_...",
    ...
  },
  "parcel": {
    "id": "prcl_...",
    ...
  },
  "customs_info": {
    "id": "cstinfo_...",
    ...
  },
  "rates": [{
    "id": "rate_..."
    ...
    }
  ],
  "scan_form": null,
  "selected_rate": null,
  "postage_label": {
    "id": "pl_...",
    ...
  },
  "tracking_code": "LN123456789US",
  "refund_status": null,
  "created_at": "2013-04-22T05:40:57Z",
  "updated_at": "2013-04-22T05:40:57Z"
}

Congratulations! You’ve just purchased insurance with EasyPost! Check out our Full Reference API Documentation.