Add Freight Shipping to Your Platform

Your backend calls POST /freights/quote

// Your user enters origin, destination, cargo in YOUR UI.
// Your backend calls Warp API. Returns rates instantly.

const response = 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-06-10"],
      pickupInfo: {
        zipCode: "90001",
        city: "Los Angeles",
        state: "CA"
      },
      deliveryInfo: {
        zipCode: "85001",
        city: "Phoenix",
        state: "AZ"
      },
      listItems: [{
        name: "Pallet",
        length: 48, width: 40, height: 48,
        sizeUnit: "in",
        totalWeight: 800, weightUnit: "lb",
        quantity: 2, packaging: "pallet"
      }]
    })
  }
);

const { data } = await response.json();
// data.quoteId, data.totalCost, data.transitDays
// Show these rates in YOUR platform UI.
// Add your margin before displaying to your user.

Your backend calls POST /freights/booking

// Your user selects a rate. Your backend books 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: data.quoteId,
      pickupInfo: {
        zipCode: "90001",
        city: "Los Angeles",
        state: "CA",
        street: "123 Warehouse Blvd",
        contactName: "Dispatch Team",
        phone: "3105551234"
      },
      deliveryInfo: {
        zipCode: "85001",
        city: "Phoenix",
        state: "AZ",
        street: "456 Distribution Dr",
        contactName: "Receiving Dock",
        phone: "6025551234"
      },
      listItems: [{
        name: "Pallet",
        length: 48, width: 40, height: 48,
        sizeUnit: "in",
        totalWeight: 800, weightUnit: "lb",
        quantity: 2, packaging: "pallet"
      }]
    })
  }
);

const shipment = await booking.json();
// shipment.data.trackingNumber → show to your user
// shipment.data.shipmentId → store in your database

Warp pushes events to your webhook endpoint

// Warp pushes status events to YOUR webhook endpoint.
// Your users see live tracking without you polling anything.

app.post("/webhooks/warp", (req, res) => {
  const event = req.body;

  // event.status: "pickupSuccessful", "inRouteToDelivery",
  //   "arrivedAtDelivery", "delivered", etc.
  // event.trackingNumber: matches the shipment
  // event.location: { city, state, timestamp }
  // event.documents: BOL, POD URLs when available

  // Update your platform's shipment record
  await db.shipments.update({
    where: { trackingNumber: event.trackingNumber },
    data: {
      status: event.status,
      lastLocation: event.location,
      updatedAt: new Date()
    }
  });

  // Notify your user in real time
  await notify(shipment.userId, {
    message: `Shipment ${event.trackingNumber}: ${event.status}`
  });

  res.status(200).send("ok");
});