Skip to content
MothershipDevelopers

API referenceReference

Invoice line items

What each invoice line item type means.

2 min read

When reviewing a freight invoice, each line item represents a specific charge or adjustment related to the shipment. Below is a guide to help you understand what each type of line item means. Amounts on line items are in cents.

Line item typeDescription
additionalA catch-all for miscellaneous charges not covered by other categories.
base-shipmentThe core transportation cost of moving freight from origin to destination.
booking-feeA fee for processing and confirming the freight booking.
cancellation-feePenalty applied when a booked shipment is canceled late in the process.
claimFinancial adjustment resulting from a damaged or lost shipment claim.
credit-card-processor-feeFee charged by the payment processor for using a credit card.
cross-dockCost incurred when freight is transferred between trucks at a distribution hub.
freight-coverageCharge for insuring the shipment against damage or loss.
fuel-surchargeA variable fee to cover fluctuating fuel costs.
fba-appointment-deliveryFee for scheduling and delivering to an Amazon Fulfillment Center (FBA).
home-deliveryExtra charge for delivering e-commerce goods within a residential location (across the threshold).
late-feeFee for overdue payments or missed pickup/delivery timeframes.
local-inside-deliveryFee for delivery beyond the curb, into a building or room locally (same day moves).
oversize-feeSurcharge for shipments that exceed standard size or weight limits.
residential-deliveryAdditional charge for delivering to a residential address (non-commercial).
residential-pickupSurcharge for collecting a shipment from a residential location.
revenue-share-adjustmentAn adjustment based on profit-sharing agreements or carrier partnerships.
scheduled-deliveryFee for deliveries requiring a specific appointment time.
scheduled-pickupCharge for pickups that require a scheduled appointment.
toll-feePass-through toll road or bridge fees incurred during transit.
twic-chargeCost for accessing secure ports or facilities requiring a TWIC credential.
appointment-deliveryFee for setting up a delivery that must be made within a booked time window.
international-transaction-feeCost associated with processing payments across international borders.
domestic-credit-card-processing-feeFee for processing U.S.-based credit card transactions.
international-credit-card-processing-feeFee for processing non-U.S. credit card payments.
cross-border-transaction-feeSurcharge for shipments or transactions crossing international borders.
financing-feeInterest or service fee for extending credit/payment terms.
dispute-feeFee charged when disputing a charge or transaction requires administrative handling.
digital-wallet-processing-feeFee for using digital payment methods like PayPal, Apple Pay, etc.

Invoice statuses

StatusDescription
openThe invoice has not been paid, or payment is still processing.
paidThe invoice has been fully paid.
unpaidListed in the spec for compatibility. The API does not return it today.
pastDueThe invoice is not fully paid and past its due date.
voidThe invoice has been voided and is not due for payment, nor has been paid previously.