API Docs

Fee

Fee objects are used to represent the breakdown of postage related charges made when purchasing an item on EasyPost.

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.

Fee object

object
string
"Fee"
type
string

The name of the category of fee. Possible values:

  • "PostageFee"
  • "InsuranceFee"
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
{
  "id": "shp_388d1ed480ba4836a93737acf23edb0d",
  "created_at": "2025-05-09T20:39:17Z",
  "is_return": false,
  "messages": [],
  "mode": "test",
  "options": {
    "currency": "USD",
    "payment": {
      "type": "SENDER"
    },
    "date_advance": 0
  },
  "reference": null,
  "status": "unknown",
  "tracking_code": "9434600208303109842211",
  "updated_at": "2025-05-09T20:39:18Z",
  "batch_id": null,
  "batch_status": null,
  "batch_message": null,
  "customs_info": {
    "id": "cstinfo_9b5fc07ece184ca58704b26ee3a88260",
    "object": "CustomsInfo",
    "created_at": "2025-05-09T20:39:17Z",
    "updated_at": "2025-05-09T20:39:17Z",
    "contents_explanation": "",
    "contents_type": "merchandise",
    "customs_certify": true,
    "customs_signer": "Steve Brule",
    "eel_pfc": "NOEEI 30.37(a)",
    "non_delivery_option": "return",
    "restriction_comments": null,
    "restriction_type": "none",
    "mode": "test",
    "declaration": null,
    "customs_items": [
      {
        "id": "cstitem_81010278f65c43e18dd6d92d947ee0c3",
        "object": "CustomsItem",
        "created_at": "2025-05-09T20:39:17Z",
        "updated_at": "2025-05-09T20:39:17Z",
        "description": "T-shirt",
        "hs_tariff_number": "123456",
        "origin_country": "US",
        "quantity": 1,
        "value": "10.0",
        "weight": 5,
        "code": "123",
        "mode": "test",
        "manufacturer": null,
        "currency": null,
        "eccn": null,
        "printed_commodity_identifier": null
      }
    ]
  },
  "from_address": {
    "id": "adr_ad9a572e2d1511f0a4433cecef1b359e",
    "object": "Address",
    "created_at": "2025-05-09T20:39:17+00:00",
    "updated_at": "2025-05-09T20:39:17+00:00",
    "name": "EasyPost",
    "company": null,
    "street1": "417 Montgomery Street",
    "street2": "5th Floor",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94104",
    "country": "US",
    "phone": "4153334445",
    "email": "support@easypost.com",
    "mode": "test",
    "carrier_facility": null,
    "residential": null,
    "federal_tax_id": null,
    "state_tax_id": null,
    "verifications": {}
  },
  "insurance": null,
  "order_id": null,
  "parcel": {
    "id": "prcl_4d4f76d40ba14e2fba31c222ad6b43a6",
    "object": "Parcel",
    "created_at": "2025-05-09T20:39:17Z",
    "updated_at": "2025-05-09T20:39:17Z",
    "length": 20.2,
    "width": 10.9,
    "height": 5,
    "predefined_package": null,
    "weight": 65.9,
    "mode": "test"
  },
  "postage_label": {
    "object": "PostageLabel",
    "id": "pl_8bfb4bcfa93f426a8acd98dcc9b18e86",
    "created_at": "2025-05-09T20:39:18Z",
    "updated_at": "2025-05-09T20:39:18Z",
    "date_advance": 0,
    "integrated_form": "none",
    "label_date": "2025-05-09T20:39:18Z",
    "label_resolution": 300,
    "label_size": "4x6",
    "label_type": "default",
    "label_file_type": "image/png",
    "label_url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250509/e8047d1b0deaa44237803e2a676a7fb3a1.png",
    "label_pdf_url": null,
    "label_zpl_url": null,
    "label_epl2_url": null,
    "label_file": null
  },
  "rates": [
    {
      "id": "rate_fa0bbc0a7bfd4fedbc7a9cd97935d2d0",
      "object": "Rate",
      "created_at": "2025-05-09T20:39:17Z",
      "updated_at": "2025-05-09T20:39:17Z",
      "mode": "test",
      "service": "Priority",
      "carrier": "USPS",
      "rate": "11.01",
      "currency": "USD",
      "retail_rate": "15.40",
      "retail_currency": "USD",
      "list_rate": "11.01",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 2,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 2,
      "shipment_id": "shp_388d1ed480ba4836a93737acf23edb0d",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    },
    {
      "id": "rate_6d43eb0e88d645b2b45de8657664bd8a",
      "object": "Rate",
      "created_at": "2025-05-09T20:39:18Z",
      "updated_at": "2025-05-09T20:39:18Z",
      "mode": "test",
      "service": "GroundAdvantage",
      "carrier": "USPS",
      "rate": "8.20",
      "currency": "USD",
      "retail_rate": "13.85",
      "retail_currency": "USD",
      "list_rate": "9.74",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 3,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 3,
      "shipment_id": "shp_388d1ed480ba4836a93737acf23edb0d",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    },
    {
      "id": "rate_b11a1be81b6646ed8e0f4a675efc8176",
      "object": "Rate",
      "created_at": "2025-05-09T20:39:18Z",
      "updated_at": "2025-05-09T20:39:18Z",
      "mode": "test",
      "service": "Express",
      "carrier": "USPS",
      "rate": "51.20",
      "currency": "USD",
      "retail_rate": "59.25",
      "retail_currency": "USD",
      "list_rate": "51.20",
      "list_currency": "USD",
      "billing_type": "easypost",
      "delivery_days": 2,
      "delivery_date": null,
      "delivery_date_guaranteed": false,
      "est_delivery_days": 2,
      "shipment_id": "shp_388d1ed480ba4836a93737acf23edb0d",
      "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
    }
  ],
  "refund_status": null,
  "scan_form": null,
  "selected_rate": {
    "id": "rate_6d43eb0e88d645b2b45de8657664bd8a",
    "object": "Rate",
    "created_at": "2025-05-09T20:39:18Z",
    "updated_at": "2025-05-09T20:39:18Z",
    "mode": "test",
    "service": "GroundAdvantage",
    "carrier": "USPS",
    "rate": "8.20",
    "currency": "USD",
    "retail_rate": "13.85",
    "retail_currency": "USD",
    "list_rate": "9.74",
    "list_currency": "USD",
    "billing_type": "easypost",
    "delivery_days": 3,
    "delivery_date": null,
    "delivery_date_guaranteed": false,
    "est_delivery_days": 3,
    "shipment_id": "shp_388d1ed480ba4836a93737acf23edb0d",
    "carrier_account_id": "ca_9685a1198a75477885a3cdca37559bac"
  },
  "tracker": {
    "id": "trk_3e9c5fe5d811421b9c0cdabc42034cea",
    "object": "Tracker",
    "mode": "test",
    "tracking_code": "9434600208303109842211",
    "status": "unknown",
    "status_detail": "unknown",
    "created_at": "2025-05-09T20:39:19Z",
    "updated_at": "2025-05-09T20:39:19Z",
    "signed_by": null,
    "weight": null,
    "est_delivery_date": null,
    "shipment_id": "shp_388d1ed480ba4836a93737acf23edb0d",
    "carrier": "USPS",
    "tracking_details": [],
    "fees": [],
    "carrier_detail": null,
    "public_url": "https://track.easypost.com/djE6dHJrXzNlOWM1ZmU1ZDgxMTQyMWI5YzBjZGFiYzQyMDM0Y2Vh"
  },
  "to_address": {
    "id": "adr_ad9801082d1511f081b2ac1f6bc539aa",
    "object": "Address",
    "created_at": "2025-05-09T20:39:17+00:00",
    "updated_at": "2025-05-09T20:39:18+00:00",
    "name": "DR. STEVE BRULE",
    "company": null,
    "street1": "179 N HARBOR DR",
    "street2": "",
    "city": "REDONDO BEACH",
    "state": "CA",
    "zip": "90277-2506",
    "country": "US",
    "phone": "8573875756",
    "email": "DR_STEVE_BRULE@GMAIL.COM",
    "mode": "test",
    "carrier_facility": null,
    "residential": false,
    "federal_tax_id": null,
    "state_tax_id": null,
    "verifications": {
      "zip4": {
        "success": true,
        "errors": [],
        "details": null
      },
      "delivery": {
        "success": true,
        "errors": [],
        "details": {
          "latitude": 33.8436,
          "longitude": -118.39177,
          "time_zone": "America/Los_Angeles"
        }
      }
    }
  },
  "usps_zone": 4,
  "return_address": {
    "id": "adr_ad9a572e2d1511f0a4433cecef1b359e",
    "object": "Address",
    "created_at": "2025-05-09T20:39:17+00:00",
    "updated_at": "2025-05-09T20:39:17+00:00",
    "name": "EasyPost",
    "company": null,
    "street1": "417 Montgomery Street",
    "street2": "5th Floor",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94104",
    "country": "US",
    "phone": "4153334445",
    "email": "support@easypost.com",
    "mode": "test",
    "carrier_facility": null,
    "residential": null,
    "federal_tax_id": null,
    "state_tax_id": null,
    "verifications": {}
  },
  "buyer_address": {
    "id": "adr_ad9801082d1511f081b2ac1f6bc539aa",
    "object": "Address",
    "created_at": "2025-05-09T20:39:17+00:00",
    "updated_at": "2025-05-09T20:39:18+00:00",
    "name": "DR. STEVE BRULE",
    "company": null,
    "street1": "179 N HARBOR DR",
    "street2": "",
    "city": "REDONDO BEACH",
    "state": "CA",
    "zip": "90277-2506",
    "country": "US",
    "phone": "8573875756",
    "email": "DR_STEVE_BRULE@GMAIL.COM",
    "mode": "test",
    "carrier_facility": null,
    "residential": false,
    "federal_tax_id": null,
    "state_tax_id": null,
    "verifications": {
      "zip4": {
        "success": true,
        "errors": [],
        "details": null
      },
      "delivery": {
        "success": true,
        "errors": [],
        "details": {
          "latitude": 33.8436,
          "longitude": -118.39177,
          "time_zone": "America/Los_Angeles"
        }
      }
    }
  },
  "forms": [],
  "fees": [
    {
      "object": "Fee",
      "type": "PostageFee",
      "amount": "8.20000",
      "charged": true,
      "refunded": false
    }
  ],
  "object": "Shipment"
}