# 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 | Property | Type | Description | |----------|------|-------------| | object | string | "Fee" | | 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 | Example Object: ```json { "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.0, "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.0, "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" } ```