Drop Freight Quotes into Any Application

Who embeds freight quoting

How embedded quoting works

The architecture is simple. Your frontend collects origin, destination, and item details from your user. Your backend proxies that request to the Warp quote endpoint with your API key. Warp returns rates as JSON. You render them in your UI however you want. When your user selects a rate, you pass the quote ID to the booking endpoint. Two calls. Quote to booked.

Frontend: collect and display

Your frontend collects shipment details and calls your own backend. Never expose your Warp API key to the client. Your backend proxies the request to Warp and returns the rates.

// Your frontend calls your backend
const response = await fetch('/api/freight-quote', {
  method: 'POST',
  body: JSON.stringify({
    origin: '90001',
    destination: '85001',
    items: [{
      length: 48, width: 40, height: 48,
      weight: 800, quantity: 2,
      packaging: 'pallet'
    }]
  })
});
const rates = await response.json();

Backend: proxy to Warp

Your backend holds the API key and calls Warp directly. The response is structured JSON with everything you need to display rates in your UI.

// Your backend proxies to Warp
const warpResponse = await fetch(
  'https://api.wearewarp.com/api/v1/freights/quote',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'apikey': process.env.WARP_API_KEY
    },
    body: JSON.stringify({
      pickupDate: ['2025-04-01'],
      pickupInfo: { zipCode: '90001' },
      deliveryInfo: { zipCode: '85001' },
      listItems: [{
        name: 'Pallet',
        length: 48, width: 40, height: 48,
        sizeUnit: 'in',
        totalWeight: 800, weightUnit: 'lb',
        quantity: 2, packaging: 'pallet'
      }]
    })
  }
);

{
  "data": {
    "quoteId": "01HG9W6CMAWHNWTVXDKW9QYFS9",
    "carrierCode": "WTCH",
    "carrierName": "Warp Technology",
    "serviceLevel": "standard",
    "transitDays": 2,
    "totalCost": 485.00,
    "pickupWindow": { "from": "08:00", "to": "17:00" },
    "deliveryWindow": { "from": "08:00", "to": "17:00" }
  }
}

Display rates your way

The quote response includes everything you need to build a rate comparison UI. Show a single cheapest option or display all available modes side by side. The data is yours to render.

Book after quote selection

When your user selects a rate, pass the quote ID to the booking endpoint along with full address and contact details. Warp returns a shipment ID, tracking number, and order ID. The shipment is confirmed and the carrier is dispatched.

// User selects a rate, you book it
const booking = await fetch(
  'https://api.wearewarp.com/api/v1/freights/booking',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'apikey': process.env.WARP_API_KEY
    },
    body: JSON.stringify({
      quoteId: selectedRate.quoteId,
      pickupInfo: { ...fullPickupDetails },
      deliveryInfo: { ...fullDeliveryDetails },
      listItems: cart.items
    })
  }
);
// Returns: shipmentId, trackingNumber, orderId

Mode comparison in your UI

Omit the vehicle type from your quote request and Warp returns rates across all eligible modes. Your users see cargo van, box truck, LTL, and truckload options side by side with price and transit time for each. Let them choose the tradeoff between speed and cost.

White label options

Warp API responses contain no branding. The carrier name field shows the actual carrier, not Warp. You control every pixel of the user experience. Show your brand on tracking pages, email notifications, and invoices. Your customers interact with your product. Warp powers the freight network behind it.

• -API responses contain zero Warp branding. Display rates under your own brand.
• -Tracking updates come as structured data. Render them in your own tracking UI.
• -Invoices and documents are available via API. Generate your own branded versions.
• -One API key per platform. You manage your own users and billing internally.

Frequently asked questions