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 get a check in the mail within 30 days. No more waiting periods, hassle or extensive forms.

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

We file claims within 24 hours and payments are made within 30 days of claims. 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.