Developer FAQ

Sign up at customer.wearewarp.com. Generate an API key in Settings > API Keys. No sales call required.

https://api.wearewarp.com/api/v1

Pass your API key in the apikey header on every request. Content type is always JSON.

Yes. Use test mode to simulate quoting, booking, and tracking without dispatching real carriers.

Any language that can make HTTP requests. REST API with JSON. Python, Node.js, Go, Java, Ruby, Rust, or any other language.

No. The API works with plain HTTP requests. Warp provides client libraries for Python and Node.js if you prefer.

Most developers get their first quote in under 5 minutes. A production integration takes a few hours. AI coding tools like Claude Code can generate the code in minutes.

Standard rate limits apply. Enterprise accounts get higher throughput. Contact Warp for details.

developer.wearewarp.com/docs/freight/

developer.wearewarp.com/docs/cli

POST /api/v1/freights/quote with origin, destination, and cargo details. Returns rates across available modes.

Minimum: origin zip, destination zip, item dimensions, weight, and quantity. Optional: freight class, vehicle type, accessorial services.

Yes. Omit the vehicleType field and Warp returns rates across LTL, box truck, cargo van, and truckload.

Quotes are valid for a set window (typically 24 to 48 hours). The expiration is included in the response.

Yes. No fuel surcharges, no hidden accessorial fees, no terminal handling charges. The quoted rate is what you pay.

Yes. Include temperature requirements in the quote request.

Not for most shipments. Warp auto-classifies based on dimensions and weight. You can specify freight class if you know it.

Yes. Use POST /api/v1/freights/quote/multi-stops.

LTL, box truck, and cargo van are priced per pallet. The rate includes pickup, cross-dock handling (for LTL), line haul, and delivery.

Yes. Get the all inclusive rate via API, add your margin, charge your customers your price.

POST /api/v1/freights/booking with the quote ID and pickup/delivery details.

Warp dispatches a local 3rd-party carrier through the Warp driver app. You receive a shipment ID and tracking number.

Yes, before pickup. Contact Warp support or use the cancellation endpoint.

Modifications to pickup date, contact info, and instructions are supported before the shipment is picked up.

Yes. Street address, city, state, zip code, and contact name/phone for both pickup and delivery.

Yes. Call the booking endpoint for each shipment. For high-volume batch operations, contact Warp for bulk booking support.

Standard business hours (8am to 5pm) by default. Appointments and custom windows can be specified.

Yes. The API supports fully autonomous operation. Set business rules (max spend, required transit, preferred modes) and let agents book within parameters.

POST /api/v1/freights/tracking with tracking numbers. Returns current status, location, and event history.

PICKED_UP, SCANNED_IN, DEPARTED, IN_TRANSIT, ARRIVED, SCANNED_OUT, DELIVERED, EXCEPTION.

Yes. Local 3rd-party carriers use the Warp driver app with live GPS, barcode scan events, proof of delivery photos, and e-signatures.

Register a webhook URL with Warp. Receive HTTP POST notifications for every shipment event in real time.

Event type, timestamp, location, shipment ID, and event-specific data (scan details, GPS coordinates, delivery photo URL).

No. Use webhooks for real time push notifications. Polling the tracking endpoint is also supported but webhooks are recommended.

Our AI backbone, Orbit, monitors every shipment for exceptions: late pickups, missed scans, route deviations, temperature deviations, dwell anomalies, and delivery exceptions. Flags issues before your team has to chase them.

Yes. ELD integrations on all line haul trucks provide continuous location data, not just check calls at pickup and delivery.

LTL (1 to 12 pallets), truckload (dry van, reefer, flatbed), box truck (26 foot, liftgate equipped), and cargo van (cartons, cases, parcels, or up to 3 pallets).

Yes. Every Warp box truck is 26 foot and liftgate equipped. Temperature controlled units available.

Cartons, cases, parcels, or up to 3 pallets. Same day dispatch available.

Freight is picked up by a local 3rd-party carrier, routed through Warp operated cross-dock facilities, moved via line haul, and delivered by another local carrier. 1 to 2 handoffs vs 3 to 5 at traditional LTL terminals.

Yes. Temperature controlled box trucks and reefer trailers available. Include temperature requirements in the quote request.

44,000 lbs for a 53 foot dry van.

Yes. Omit the vehicleType field and Warp selects the best option based on your cargo details.

$0. No software fees, no per-API-call charges, no integration fees. You pay when you ship.

No. All inclusive pricing. No fuel surcharges, no accessorial fees, no terminal handling charges.

GET /api/v1/freights/invoices/{orderId}. Returns structured JSON with line items, totals, and charges.

Yes. GET /api/v1/freights/documents/{orderId}. Returns document URLs, types, and metadata.

For recurring volume, a Warp rep builds a custom rate card. Contact Warp at wearewarp.com/book-a-meeting.

Yes. Claude Code can make HTTP requests to the Warp API. It reads the docs, constructs requests based on natural language descriptions, and handles responses.

Any tool that makes HTTP requests: Claude Code, Cursor, Codex, LangChain, CrewAI, custom agents.

Yes. The CLI outputs structured, parseable data. AI agents can execute warp quote, warp book, warp track as shell commands.

AI that autonomously takes action on freight operations: quoting, booking, tracking, exception handling, and invoice reconciliation. Not just alerts.

Use the Warp API for freight operations and your AI framework (LangChain, CrewAI, custom) for decision logic. See wearewarp.com/ai-freight-agent for a full guide.