Skip to content 
A freight booking API is a connection that lets your ERP, TMS or order system turn a quote into a confirmed shipment and send updates, changes and cancellations without email.
Quoting tells you what a move should cost. Booking commits capacity, a pickup window and a set of parties to that move. Most of the manual work in freight sits between those two moments: copying addresses into a portal, emailing pickup times, chasing confirmations. A booking API closes that gap. This guide walks through the booking lifecycle, the data a booking needs, what happens to documents, and how changes are handled, using the ExFreight freight API as the reference point.
Key takeaways
- A booking request carries the quote reference plus the full operational detail the quote did not need: names, contacts, dock hours, references and pickup window.
- A booking is a lifecycle, not a single call: request, confirmation, updates, changes and, when needed, cancellation.
- Booked freight is still subject to re-invoicing if actual weight, dimensions or services differ from the booking.
What a freight booking API automates
A freight booking is the instruction that commits a carrier or forwarder to move a specific shipment, between named parties, on a set schedule, at an agreed price. The API version of that instruction replaces four manual tasks:
- Data entry. Shipper, consignee, commodity and handling unit data move from your order record to the forwarder without retyping.
- Pickup scheduling. The requested pickup date and dock hours go with the booking, so dispatch does not need a separate call.
- Confirmation. Your system receives a booking reference and stores it against the order, ready for tracking and invoice matching.
- Change control. Updates and cancellations go through the same channel, with a record of who changed what.
For context on how shippers moved from phone and fax to online and API booking, see the evolution of digital freight booking. The rest of this guide stays on the mechanics.
Booking lifecycle step by step
The sequence below applies whether the freight is a domestic LTL shipment or an international LCL move. The ExFreight booking API covers all booking activity, updates, changes and confirmations.
- Quote. Your system requests rates and selects an option. The selected option carries a quote reference and a validity window. See the freight quote API guide for request fields.
- Book. Send the quote reference with full party details, pickup window, references and any services added since the quote.
- Confirm. The booking is acknowledged with a booking reference. Store it in the order record; it is the key for tracking and billing.
- Update. As the shipment progresses, booking status changes. Pickup scheduled, picked up, in transit, delivered. The freight tracking API guide covers the status events that follow pickup.
- Change or cancel. If the order changes before pickup, modify the booking or cancel it through the same channel, then re-quote if the freight itself changed.
Status values differ by provider, but most booking flows map to the states below. Use them as the internal model in your system, then map the provider’s statuses onto it during integration.
| Status | Meaning | What your system should do |
|---|---|---|
| requested | Booking sent, not yet confirmed | Hold the order in “booking pending”; alert if unconfirmed past your cutoff |
| confirmed | Booking accepted, reference issued | Store booking reference; release pick and pack |
| changed | Details amended after confirmation | Log the change and who requested it; re-check price impact |
| picked up | Freight tendered to the carrier | Close warehouse task; start tracking |
| cancelled | Booking withdrawn before pickup | Reopen the order; release any reserved dock slot |
Data a booking needs that a quote does not
A quote only needs enough data to price the move. A booking needs enough to execute it. The gap is where most failed pickups start. Conceptually, a booking request adds:
- Full shipper and consignee details. Company name, street address, contact name, phone and email at both ends.
- Pickup window and dock hours. Ready time and close time. A driver who arrives at 4:30 PM to a dock that closes at 4:00 PM is a missed pickup and a possible re-delivery charge.
- Commodity description. Plain description of goods, consistent with the commercial invoice on international moves.
- References. PO number, order number, SKU or customer reference, so the receiver and your accounts payable team can match the shipment.
- Special instructions. Appointment requirements, gate codes, delivery restrictions.
- Optional services. On the ExFreight platform, all-risk cargo insurance can be added at booking, with an instant downloadable certificate.
Worked example: booking the Chicago to Rotterdam LCL shipment
The exporter quoted 4 pallets, 2,600 lb and 7.55 cubic meters, from Chicago (60607) to a consignee near Rotterdam, door-to-door. The booking adds the warehouse contact and dock hours (7:00 AM to 3:30 PM local time, no liftgate needed), the consignee’s company and contact details in the Netherlands, the PO number, and a commodity description that matches the commercial invoice. Because the rate is door-to-door, export declaration filing is included. If the shipper’s warehouse later reports 5 pallets instead of 4, the right move is to update and re-quote before pickup rather than let the difference surface on the invoice.
Worked example: booking the Chicago to Dallas LTL shipment
For 2 pallets of hardware (1,000 lb, 48 x 40 x 48 inches each) from Chicago (60607) to Dallas (75247), the booking adds what the quote left out: the shipper’s ready time and dock close time, the receiver’s delivery hours, a delivery appointment requirement if the customer has one, and the PO number the receiver will check against. The liftgate that was priced in the quote must appear again in the booking instructions, so the carrier sends the right equipment. A booking that drops an accessorial priced at the quote stage is as costly as a quote that never included it: the driver arrives without a liftgate, and the redelivery is billed.
Quotes are informational and subject to change. Shipments can be re-invoiced if actual details differ from the booking. Accessorials, detention, storage and, on imports, duties, taxes, bonds, MPF and HMF are billed separately.
Documents tied to a booking
A booked shipment generates paperwork: a bill of lading, a commercial invoice and packing list on international moves, an insurance certificate when cover is bought, and a proof of delivery at the end. Some booking APIs return documents in the booking response; others keep documents in the provider’s platform.
On the ExFreight platform, shipment documents are uploaded and stored online with the booking, and invoices are available online for payment by credit card or ACH. How documents such as the bill of lading are handled for API users is confirmed during onboarding. If your process depends on pulling documents into your own system, raise it at the start of the integration so the workflow is agreed before go-live. The bill of lading API guide explains the eBOL standards carriers are adopting.
Ocean carriers are moving in the same direction. The DCSA Booking standard defines a common data model for container bookings, so booking data does not have to be rekeyed into shipping instructions.
Changes and cancellations
Changes are where manual booking processes fail. An email to update a pickup time sits in an inbox while the truck is already dispatched. An API change request carries the booking reference and the amended fields, and the response confirms whether the change was accepted.
| Email or portal booking | API booking | |
|---|---|---|
| Data entry | Rekeyed by a planner, per shipment | Sent from the order record |
| Confirmation | Arrives by email, copied into the ERP by hand | Returned to your system and stored against the order |
| Changes | Phone or email; audit trail scattered | Change request with booking reference; logged |
| Error rate | Rises with volume and staff turnover | Limited to source data quality |
| Scale | Linear with headcount | Handles volume peaks without added staff |
Operator rules that save money:
- Change before pickup, not after. Weight, piece count or address changes after pickup turn into re-invoices, re-delivery or reconsignment charges.
- Cancel early. A truck that arrives to a cancelled load can trigger a truck-ordered-not-used (TONU) charge.
- Re-quote when the freight changes. A changed pallet count is a different shipment. A changed contact name is not.
- Keep one owner per booking. When two planners edit the same booking from different systems, the last write wins and nobody knows it.
Domestic trucking bookings on ExFreight are arranged with ExFreight acting as a broker (FMCSA MC-677423-B); on ocean and air, ExFreight is the licensed carrier. That distinction matters for liability and claims, and it is set at booking.
What ExFreight’s API covers today
Available upon request, with a test environment and assistance. Existing TMS integrations include Project 44, Accufrate, Banyan, SAAS, 7L, Primus, Pacejet, CSA Software and Teknowlogi. See how the ExFreight freight API works
Freight API series
Frequently asked questions
What is a freight booking?
A freight booking is the instruction that commits a carrier or forwarder to move a specific shipment between named parties on a set schedule. It carries the quote reference, shipper and consignee details, pickup window, commodity and references. Once confirmed, it receives a booking reference used for tracking, documents and invoice matching.
How much does API cost?
API pricing varies by provider. Some charge per call, some charge a monthly subscription, and many freight forwarders include API access with a shipping account, so you pay for freight moved rather than for calls. ExFreight's APIs are available upon request; contact salesbox@exfreight.com to discuss access, terms and the test environment.
Can I change a booking after it is confirmed?
Yes, before pickup. Send the change with the booking reference and the amended details. Contact or time changes are routine. Changes to pallet count, weight, dimensions or addresses alter the shipment itself, so re-quote first. Changes made after pickup usually lead to re-invoicing, re-delivery or reconsignment charges.
What happens if I cancel a freight booking?
Cancel as early as possible through the same channel used to book. A cancellation before dispatch is usually simple. If a truck has already been sent to the pickup location, the carrier may bill a truck-ordered-not-used (TONU) charge. Reopen the order in your system so it can be quoted and booked again.
