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.
Endpoints
Request Parameters
amount
i.e. 200.00
POST /
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}