Looking for the old docs? View our old docs site.

Fee

Fee objects are used to represent the breakdown of charges made when purchasing an item on EasyPost. Shipments and Trackers both have associations to Fee objects.

Each Shipment object will have a Fee of type "LabelFee" to represent the label fee charged by EasyPost for the service. Shipments with postage collected by EasyPost (as opposed to shipments with postage collected directly by the carrier) will have a "PostageFee" according to the postage amount.

Insurance on a shipment will add an "InsuranceFee" with the insurance premium (not the covered value) for the amount. Tracker objects will have a "TrackerFee" with the price, even when a tracker is free.


Fee object

object
string
"Fee"
mode
string
"test" or "production"
type
string

The name of the category of fee. Possible values:

  • "LabelFee"
  • "PostageFee"
  • "InsuranceFee"
  • "TrackerFee"
amount
string
USD value with sub-cent precision
charged
boolean
Whether EasyPost has successfully charged your account for the fee
refunded
boolean
Whether the fee has been refunded successfully
Fee Object
{
  "object": "Fee",
  "type": "LabelFee",
  "amount": "0.00000",
  "charged": true,
  "refunded": false
}