Freight API — Quote, book, track, settle.

# WARP FREIGHT API — AGENT REFERENCE
# Base URL: https://api.wearewarp.com/api/v1
# Auth: Header "apikey: <your-api-key>"
# Content-Type: application/json

## AGENT WORKFLOW (HAPPY PATH)
1. POST /freights/quote → get quoteId and totalCost
2. POST /freights/booking → use quoteId, get shipmentId + trackingNumber
3. POST /freights/tracking → poll status using trackingNumber
4. GET /freights/events/{shipmentId} → full event history
5. GET /freights/invoices/{orderId} → settlement data
6. GET /freights/documents/{orderId} → BOL, POD files

## CAPABILITIES
- Quote freight (LTL, FTL, cargo van, box truck) in one API call
- Book shipments programmatically with tracking number returned
- Track shipment status and location in real time
- Retrieve invoices and documents (BOL, POD) by order ID
- Multi-stop FTL quoting and booking
- 20+ accessorial services priced at quote time
- Vehicle type auto-selection when vehicleType is omitted

## ENDPOINTS
POST /freights/quote → 200 → { quoteId, carrierCode, serviceLevel, transitDays, totalCost }
POST /freights/booking → 201 → { shipmentId, trackingNumber, orderId, status }
POST /freights/tracking → 200 → [{ trackingNumber, status, currentLocation, events }]
GET  /freights/shipments → 200 → [{ shipmentId, shipmentType, status, pickupInfo, deliveryInfo }]
GET  /freights/events/{shipmentId} → 200 → [{ status, location, timestamp, description }]
GET  /freights/invoices/{orderId} → 200 → { lineItems, totals, charges }
GET  /freights/documents/{orderId} → 200 → [{ type, url, metadata }]
POST /freights/quote/multi-stops → 200 → { quoteId, totalCost, stops }
POST /freights/booking/multi-stops → 201 → { shipmentId, trackingNumber }
GET  /freights/quote-history → 200 → [{ quoteId, totalCost, status, expiresAt }]

## VEHICLE TYPES
CARGO_VAN → Cargo van (urgent, <3500 lbs, fastest dispatch)
STRAIGHT_TRUCK_26 → 26ft box truck (<10000 lbs, white-glove capable)
DRY_VAN_53 → 53ft dry van / FTL (<44000 lbs, recurring lanes)

## SHIPMENT TYPES
LTL → Less-than-truckload (pallet freight, cross dock network)
FTL → Full truckload (dedicated trailer, direct lanes)
omit → Warp auto-selects based on item dimensions and weight

## QUOTE BODY FIELDS
pickupDate (string[]), pickupInfo (StopInfo), deliveryInfo (StopInfo),
listItems (BookShipmentItem[]), shipmentType? ("LTL"|"FTL"),
vehicleType? ("CARGO_VAN"|"STRAIGHT_TRUCK_26"|"DRY_VAN_53"),
pickupServices? (string[]), deliveryServices? (string[]),
additionalServices? (string[])

## STOP INFO FIELDS
zipCode, city, state, street, contactName, phone, email?, specialInstruction?, window?

## ITEM FIELDS (BookShipmentItem)
name, length, width, height, sizeUnit ("in"|"cm"),
totalWeight, weightUnit ("lb"|"kg"), quantity,
packaging, stackable (bool), temperature_limit?

## PICKUP SERVICES
"liftgate-pickup", "inside-pickup", "residential-pickup",
"limited-access-pickup", "pickup-appointment", "driver-assist-pickup",
"drop-and-hook-pickup", "convention-trade-show-pickup",
"construction-site-pickup", "detention-shipper"

## DELIVERY SERVICES
"liftgate-delivery", "inside-delivery", "residential-delivery",
"limited-access-delivery", "delivery-appointment", "driver-assist-delivery",
"drop-and-hook-delivery", "convention-trade-show-delivery",
"construction-site-delivery", "detention-receiver", "redelivery"

## ADDITIONAL SERVICES
"sort-n-seg", "extra-stop", "extra-miles", "driver-assist",
"white-glove", "check_calls", "notify", "photo-required"

## ERROR CODES
200 OK, 201 Created, 400 Bad Request, 401 Unauthorized,
403 Forbidden, 404 Not Found, 422 Unprocessable, 429 Rate Limited, 500 Server Error

## ERROR RESPONSE SHAPE
{ "error": { "code": "string", "message": "string", "details": [{ "field": "string", "issue": "string" }] } }

## NETWORK
1,500+ active lanes | 50+ cross dock facilities
10,000+ carriers | 9,000+ vehicles
Coverage: United States

## GET API KEY
Contact: https://www.wearewarp.com/book-a-meeting
Full docs: https://developer.wearewarp.com/docs/freight/
LLM context: https://www.wearewarp.com/llms-full.txt