Agent API docs
Warp supports four dry freight modes. FTL takes 3 fields. Van and box truck take 5. LTL takes 7. After your first shipment on a lane, rebook with just lane_id and pickup_date.
Van freight API5 fields: origin, destination, pallets, weight, pickup date. Best for small shipments under 5 pallets.Box truck freight API5 fields: origin, destination, pallets, weight, pickup date. Fits up to 12 pallets, residential friendly.FTL freight API3 fields: origin, destination, pickup date. Weight and pallets are optional. 53 ft dry van.LTL freight API7 fields: origin, destination, pallets, weight, commodity, dims, pickup date. Freight class is optional -- Warp uses FAK rates.
Canonical quote response
Every mode returns this shape. The quote_tier tells your agent whether the quote is ready to book.
{
"quote_id": "wq_...",
"lane_id": "ln_900_100",
"mode": "van",
"price_usd": 1850.00,
"currency": "USD",
"transit_days": 5,
"pickup_date": "2026-04-14",
"delivery_date": "2026-04-19",
"expires_at": "2026-04-11T15:30:00Z",
"quote_tier": "firm",
"assumptions": {
"weight_lbs_per_pallet": 800,
"dims_in": { "length": 96, "width": 48, "height": 48 }
},
"missing_for_ship": [],
"booking_url": "https://wearewarp.com/agents/book/wq_...",
"book_tool_call": {
"tool": "warp_book",
"args": { "quote_id": "wq_..." }
}
}Fields explained
- quote_id -- unique identifier, starts with wq_
- lane_id -- reuse this for repeat shipments (2 field rebook: lane_id + pickup_date)
- quote_tier -- "firm" means ready to book, "indicative" means needs more info
- missing_for_ship -- empty array = bookable. If not empty, fill these fields first.
- book_tool_call -- copy paste this into your agent to book