Liability Coverages

Liability coverages can be added to a shipment to cover shipments that contain valuable items. Liability coverage resources are specific per contract and can cover multiple value ranges. This concerns broker-offered liability coverage. Carrier liability coverage might be available as a service option.

Note

Liability coverages are currently not offered as a product on custom contracts.

Attributes

Attribute

Type

Description

Required

name

string

Name of the liability coverage.

price

price

How much this particular liability coverage costs.

coverage_max

price

Maximum value coverage of this liability coverage.

Relationship

Type

Description

Required

contract

contract

The contract that these liability coverages are available for.

Endpoints

GET /liability-coverages/{liability-coverage_id}

Retrieving a specific liability coverage.

Scope

Any of the following scopes:

  • shipments.manage

  • organizations.manage

Request

GET /liability-coverages/{liability-coverage_id} HTTP/1.1
Accept: application/vnd.api+json
Example: https://api.sandbox.myparcel.com/liability-coverages/5a7ef73a-ddea-11e9-8a34-2a2ae2dbcce4

Response

{
  "data": {
    "type": "liability-coverages",
    "id": "5a7ef73a-ddea-11e9-8a34-2a2ae2dbcce4",
    "attributes": {
      "name": "Liability coverage up to GBP 250 value.",
      "price": {
        "amount": 995,
        "currency": "EUR"
      },
      "coverage_max": {
        "amount": 995,
        "currency": "EUR"
      }
    },
    "relationships": {
      "contract": {
        "data": {
          "type": "contracts",
          "id": "2cb32706-5762-4b96-9212-327e6afaeeff"
        },
        "links": {
          "related": "https://api.myparcel.com/contracts/2cb32706-5762-4b96-9212-327e6afaeeff"
        }
      }
    },
    "links": {
      "self": "https://api.myparcel.com/liability-coverages/5a7ef73a-ddea-11e9-8a34-2a2ae2dbcce4"
    }
  }
}

Tip

To find out what the available liability coverages for a shipment are, the shipment’s contract resource should be retrieved using the GET /contracts/{contract_id} endpoint. If the contract offers liability coverage, the available liability coverages resources will be listed as relationships on the contract.