Shipping Insurance

Shipping insurance can be purchased for any Shipment by specifying the value of the shipment's contents. The cost is 1.0% of the declared value, with a minimum charge of $0.50. All claims are processed and paid within 10 days.

To obtain insurance, first Buy a Shipment, then make the insurance call before the carrier begins handling the package.


Insure a Shipment

Request Parameters

amount
i.e. 200.00
POST /shipments/:id/insure
1curl -X POST https://api.easypost.com/v2/shipments/shp_.../insure \
2  -u "EASYPOST_API_KEY": \
3  -H 'Content-Type: application/json' \
4  -d '{
5    "amount": "200"
6  }'
Response
1{
2  "created_at": "2024-01-24T00:07:39Z",
3  "is_return": false,
4  "messages": [],
5  "mode": "test",
6  "options": {
7    "currency": "USD",
8    "payment": {
9      "type": "SENDER"
10    },
11    "date_advance": 0
12  },
13  "reference": null,
14  "status": "unknown",
15  "tracking_code": "9405500207552011812870",
16  "updated_at": "2024-01-24T00:07:40Z",
17  "batch_id": null,
18  "batch_status": null,
19  "batch_message": null,
20  "customs_info": {
21    "id": "cstinfo_894bee92fc8a4590b1bedd7c25d420aa",
22    "object": "CustomsInfo",
23    "created_at": "2024-01-24T00:07:39Z",
24    "updated_at": "2024-01-24T00:07:39Z",
25    "contents_explanation": "",
26    "contents_type": "merchandise",
27    "customs_certify": true,
28    "customs_signer": "Steve Brule",
29    "eel_pfc": "NOEEI 30.37(a)",
30    "non_delivery_option": "return",
31    "restriction_comments": null,
32    "restriction_type": "none",
33    "mode": "test",
34    "declaration": null,
35    "customs_items": [
36      {
37        "id": "cstitem_0e02f1ec747d40c390300494b5378f40",
38        "object": "CustomsItem",
39        "created_at": "2024-01-24T00:07:39Z",
40        "updated_at": "2024-01-24T00:07:39Z",
41        "description": "T-shirt",
42        "hs_tariff_number": "123456",
43        "origin_country": "US",
44        "quantity": 1,
45        "value": "10.0",
46        "weight": 5.0,
47        "code": "123",
48        "mode": "test",
49        "manufacturer": null,
50        "currency": null,
51        "eccn": null,
52        "printed_commodity_identifier": null
53      }
54    ]
55  },
56  "from_address": {
57    "id": "adr_95ff946cba4c11eea9293cecef1b359e",
58    "object": "Address",
59    "created_at": "2024-01-24T00:07:39+00:00",
60    "updated_at": "2024-01-24T00:07:39+00:00",
61    "name": "EasyPost",
62    "company": null,
63    "street1": "417 Montgomery Street",
64    "street2": "5th Floor",
65    "city": "San Francisco",
66    "state": "CA",
67    "zip": "94104",
68    "country": "US",
69    "phone": "4153334445",
70    "email": "support@easypost.com",
71    "mode": "test",
72    "carrier_facility": null,
73    "residential": null,
74    "federal_tax_id": null,
75    "state_tax_id": null,
76    "verifications": {}
77  },
78  "insurance": "100.00",
79  "order_id": null,
80  "parcel": {
81    "id": "prcl_2594ceec6c574946b89134e60fe4bc13",
82    "object": "Parcel",
83    "created_at": "2024-01-24T00:07:39Z",
84    "updated_at": "2024-01-24T00:07:39Z",
85    "length": 20.2,
86    "width": 10.9,
87    "height": 5.0,
88    "predefined_package": null,
89    "weight": 65.9,
90    "mode": "test"
91  },
92  "postage_label": {
93    "object": "PostageLabel",
94    "id": "pl_ae919bc0b3234b27a5c076d3975bba6d",
95    "created_at": "2024-01-24T00:07:39Z",
96    "updated_at": "2024-01-24T00:07:40Z",
97    "date_advance": 0,
98    "integrated_form": "none",
99    "label_date": "2024-01-24T00:07:39Z",
100    "label_resolution": 300,
101    "label_size": "4x6",
102    "label_type": "default",
103    "label_file_type": "image/png",
104    "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240124/e81a3e19aeea384a65afa1f447056de071.png",
105    "label_pdf_url": null,
106    "label_zpl_url": null,
107    "label_epl2_url": null,
108    "label_file": null
109  },
110  "rates": [
111    {
112      "id": "rate_cfd85c8adde54ed8b8c6f579266254f7",
113      "object": "Rate",
114      "created_at": "2024-01-24T00:07:39Z",
115      "updated_at": "2024-01-24T00:07:39Z",
116      "mode": "test",
117      "service": "Express",
118      "carrier": "USPS",
119      "rate": "49.60",
120      "currency": "USD",
121      "retail_rate": "57.40",
122      "retail_currency": "USD",
123      "list_rate": "49.60",
124      "list_currency": "USD",
125      "billing_type": "easypost",
126      "delivery_days": null,
127      "delivery_date": null,
128      "delivery_date_guaranteed": false,
129      "est_delivery_days": null,
130      "shipment_id": "shp_3a557aeedf24430194ce622a7d2e84d0",
131      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
132    },
133    {
134      "id": "rate_00b65803675a45c490686889492ee95d",
135      "object": "Rate",
136      "created_at": "2024-01-24T00:07:39Z",
137      "updated_at": "2024-01-24T00:07:39Z",
138      "mode": "test",
139      "service": "Priority",
140      "carrier": "USPS",
141      "rate": "7.33",
142      "currency": "USD",
143      "retail_rate": "15.20",
144      "retail_currency": "USD",
145      "list_rate": "10.89",
146      "list_currency": "USD",
147      "billing_type": "easypost",
148      "delivery_days": 2,
149      "delivery_date": null,
150      "delivery_date_guaranteed": false,
151      "est_delivery_days": 2,
152      "shipment_id": "shp_3a557aeedf24430194ce622a7d2e84d0",
153      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
154    },
155    {
156      "id": "rate_8d0a7124e1f243d98b487a2e0590cc5f",
157      "object": "Rate",
158      "created_at": "2024-01-24T00:07:39Z",
159      "updated_at": "2024-01-24T00:07:39Z",
160      "mode": "test",
161      "service": "GroundAdvantage",
162      "carrier": "USPS",
163      "rate": "6.79",
164      "currency": "USD",
165      "retail_rate": "13.15",
166      "retail_currency": "USD",
167      "list_rate": "9.41",
168      "list_currency": "USD",
169      "billing_type": "easypost",
170      "delivery_days": 3,
171      "delivery_date": null,
172      "delivery_date_guaranteed": false,
173      "est_delivery_days": 3,
174      "shipment_id": "shp_3a557aeedf24430194ce622a7d2e84d0",
175      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
176    },
177    {
178      "id": "rate_ca4b5b54136445578a7e68fee3bde594",
179      "object": "Rate",
180      "created_at": "2024-01-24T00:07:39Z",
181      "updated_at": "2024-01-24T00:07:39Z",
182      "mode": "test",
183      "service": "First",
184      "carrier": "USPS",
185      "rate": "6.79",
186      "currency": "USD",
187      "retail_rate": "13.15",
188      "retail_currency": "USD",
189      "list_rate": "9.41",
190      "list_currency": "USD",
191      "billing_type": "easypost",
192      "delivery_days": 3,
193      "delivery_date": null,
194      "delivery_date_guaranteed": false,
195      "est_delivery_days": 3,
196      "shipment_id": "shp_3a557aeedf24430194ce622a7d2e84d0",
197      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
198    },
199    {
200      "id": "rate_7b08acaea4f94f4bacc1e53a9388a396",
201      "object": "Rate",
202      "created_at": "2024-01-24T00:07:39Z",
203      "updated_at": "2024-01-24T00:07:39Z",
204      "mode": "test",
205      "service": "ParcelSelect",
206      "carrier": "USPS",
207      "rate": "6.79",
208      "currency": "USD",
209      "retail_rate": "13.15",
210      "retail_currency": "USD",
211      "list_rate": "9.41",
212      "list_currency": "USD",
213      "billing_type": "easypost",
214      "delivery_days": 3,
215      "delivery_date": null,
216      "delivery_date_guaranteed": false,
217      "est_delivery_days": 3,
218      "shipment_id": "shp_3a557aeedf24430194ce622a7d2e84d0",
219      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
220    }
221  ],
222  "refund_status": null,
223  "scan_form": null,
224  "selected_rate": {
225    "id": "rate_00b65803675a45c490686889492ee95d",
226    "object": "Rate",
227    "created_at": "2024-01-24T00:07:39Z",
228    "updated_at": "2024-01-24T00:07:39Z",
229    "mode": "test",
230    "service": "Priority",
231    "carrier": "USPS",
232    "rate": "7.33",
233    "currency": "USD",
234    "retail_rate": "15.20",
235    "retail_currency": "USD",
236    "list_rate": "10.89",
237    "list_currency": "USD",
238    "billing_type": "easypost",
239    "delivery_days": 2,
240    "delivery_date": null,
241    "delivery_date_guaranteed": false,
242    "est_delivery_days": 2,
243    "shipment_id": "shp_3a557aeedf24430194ce622a7d2e84d0",
244    "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
245  },
246  "tracker": {
247    "id": "trk_0cc56e231b894ad3b639c168afff48a5",
248    "object": "Tracker",
249    "mode": "test",
250    "tracking_code": "9405500207552011812870",
251    "status": "pre_transit",
252    "status_detail": "status_update",
253    "created_at": "2024-01-24T00:07:40Z",
254    "updated_at": "2024-01-24T00:07:40Z",
255    "signed_by": null,
256    "weight": null,
257    "est_delivery_date": "2024-01-24T00:07:40Z",
258    "shipment_id": "shp_3a557aeedf24430194ce622a7d2e84d0",
259    "carrier": "USPS",
260    "tracking_details": [
261      {
262        "object": "TrackingDetail",
263        "message": "Pre-Shipment Info Sent to USPS",
264        "description": "",
265        "status": "pre_transit",
266        "status_detail": "status_update",
267        "datetime": "2023-12-24T00:07:40Z",
268        "source": "USPS",
269        "carrier_code": "",
270        "tracking_location": {
271          "object": "TrackingLocation",
272          "city": null,
273          "state": null,
274          "country": null,
275          "zip": null
276        }
277      },
278      {
279        "object": "TrackingDetail",
280        "message": "Shipping Label Created",
281        "description": "",
282        "status": "pre_transit",
283        "status_detail": "status_update",
284        "datetime": "2023-12-24T12:44:40Z",
285        "source": "USPS",
286        "carrier_code": "",
287        "tracking_location": {
288          "object": "TrackingLocation",
289          "city": "HOUSTON",
290          "state": "TX",
291          "country": null,
292          "zip": "77063"
293        }
294      }
295    ],
296    "fees": [],
297    "carrier_detail": {
298      "object": "CarrierDetail",
299      "service": "First-Class Package Service",
300      "container_type": null,
301      "est_delivery_date_local": null,
302      "est_delivery_time_local": null,
303      "origin_location": "HOUSTON TX, 77001",
304      "origin_tracking_location": {
305        "object": "TrackingLocation",
306        "city": "HOUSTON",
307        "state": "TX",
308        "country": null,
309        "zip": "77063"
310      },
311      "destination_location": "CHARLESTON SC, 29401",
312      "destination_tracking_location": null,
313      "guaranteed_delivery_date": null,
314      "alternate_identifier": null,
315      "initial_delivery_attempt": null
316    },
317    "public_url": "https://track.easypost.com/djE6dHJrXzBjYzU2ZTIzMWI4OTRhZDNiNjM5YzE2OGFmZmY0OGE1"
318  },
319  "to_address": {
320    "id": "adr_95fd84d7ba4c11ee9fdbac1f6bc539ae",
321    "object": "Address",
322    "created_at": "2024-01-24T00:07:39+00:00",
323    "updated_at": "2024-01-24T00:07:39+00:00",
324    "name": "DR. STEVE BRULE",
325    "company": null,
326    "street1": "179 N HARBOR DR",
327    "street2": null,
328    "city": "REDONDO BEACH",
329    "state": "CA",
330    "zip": "90277-2506",
331    "country": "US",
332    "phone": "8573875756",
333    "email": "DR_STEVE_BRULE@GMAIL.COM",
334    "mode": "test",
335    "carrier_facility": null,
336    "residential": false,
337    "federal_tax_id": null,
338    "state_tax_id": null,
339    "verifications": {
340      "zip4": {
341        "success": true,
342        "errors": [],
343        "details": null
344      },
345      "delivery": {
346        "success": true,
347        "errors": [],
348        "details": {
349          "latitude": 33.8436,
350          "longitude": -118.39177,
351          "time_zone": "America/Los_Angeles"
352        }
353      }
354    }
355  },
356  "usps_zone": 4,
357  "return_address": {
358    "id": "adr_95ff946cba4c11eea9293cecef1b359e",
359    "object": "Address",
360    "created_at": "2024-01-24T00:07:39+00:00",
361    "updated_at": "2024-01-24T00:07:39+00:00",
362    "name": "EasyPost",
363    "company": null,
364    "street1": "417 Montgomery Street",
365    "street2": "5th Floor",
366    "city": "San Francisco",
367    "state": "CA",
368    "zip": "94104",
369    "country": "US",
370    "phone": "4153334445",
371    "email": "support@easypost.com",
372    "mode": "test",
373    "carrier_facility": null,
374    "residential": null,
375    "federal_tax_id": null,
376    "state_tax_id": null,
377    "verifications": {}
378  },
379  "buyer_address": {
380    "id": "adr_95fd84d7ba4c11ee9fdbac1f6bc539ae",
381    "object": "Address",
382    "created_at": "2024-01-24T00:07:39+00:00",
383    "updated_at": "2024-01-24T00:07:39+00:00",
384    "name": "DR. STEVE BRULE",
385    "company": null,
386    "street1": "179 N HARBOR DR",
387    "street2": null,
388    "city": "REDONDO BEACH",
389    "state": "CA",
390    "zip": "90277-2506",
391    "country": "US",
392    "phone": "8573875756",
393    "email": "DR_STEVE_BRULE@GMAIL.COM",
394    "mode": "test",
395    "carrier_facility": null,
396    "residential": false,
397    "federal_tax_id": null,
398    "state_tax_id": null,
399    "verifications": {
400      "zip4": {
401        "success": true,
402        "errors": [],
403        "details": null
404      },
405      "delivery": {
406        "success": true,
407        "errors": [],
408        "details": {
409          "latitude": 33.8436,
410          "longitude": -118.39177,
411          "time_zone": "America/Los_Angeles"
412        }
413      }
414    }
415  },
416  "forms": [],
417  "fees": [
418    {
419      "object": "Fee",
420      "type": "LabelFee",
421      "amount": "0.00000",
422      "charged": true,
423      "refunded": false
424    },
425    {
426      "object": "Fee",
427      "type": "PostageFee",
428      "amount": "7.33000",
429      "charged": true,
430      "refunded": false
431    },
432    {
433      "object": "Fee",
434      "type": "InsuranceFee",
435      "amount": "0.50000",
436      "charged": true,
437      "refunded": false
438    }
439  ],
440  "id": "shp_3a557aeedf24430194ce622a7d2e84d0",
441  "object": "Shipment"
442}