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.
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-07-14",
"delivery_date": "2026-04-19",
"expires_at": "2026-07-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://customer.wearewarp.com/public/freight-quote?quote_id=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