Purchase insurance (retired)
Purchase insurance
**This endpoint is retired and always returns HTTP 410.** Every request fails with `ENDPOINT_RETIRED` before authentication — there is no way to succeed against it.
Insuring a label after it has been bought is not supported: it cannot carry the signature-on-delivery surcharge that is declared at purchase time.
Declare coverage at purchase time instead, with `options.insurance_amount` on `POST /v1/labels`.
Parameters
Request Body
label_id
string
Required
ID of the shipping label to insure
insurance_value
number
Required
Insurance coverage amount (max $50,000)
Returns
410
ENDPOINT_RETIRED — always. Use options.insurance_amount on POST /v1/labels.
Related
Insurance
POST/api/v1/insurances