Ship Your First Load in 5 Minutes

Prerequisites

• -A Warp account (sign up at customer.wearewarp.com)
• -An API key (generated in the Warp dashboard under Settings → API Keys)
• -Any HTTP client: curl, Postman, Python requests, Node.js fetch, or an AI coding tool

Step 1: Authenticate

All requests use a single API key passed as an apikey header. No OAuth flows, no token refresh, no Bearer prefix. Every endpoint lives under one base URL.

curl -X GET https://api.wearewarp.com/api/v1/freights/shipments \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY"

If you get a 200 response with a list of shipments (or an empty array), your key works. A 401 means the key is missing or invalid.

Step 2: Get a freight quote

Send your origin, destination, pickup date, and item details. Warp returns a rate, transit time, and a quoteId you will use to book.

curl -X POST https://api.wearewarp.com/api/v1/freights/quote \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY" \
  -d '{
    "pickupDate": ["2026-04-07"],
    "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 - Retail Goods",
      "length": 48, "width": 40, "height": 48,
      "sizeUnit": "in",
      "totalWeight": 800, "weightUnit": "lb",
      "quantity": 2,
      "packaging": "pallet",
      "stackable": false
    }],
    "shipmentType": "LTL"
  }'

{
  "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" }
  }
}

The rate is all inclusive. No fuel surcharges, no accessorial fees, no terminal handling charges. The quoteId is what you use to book.

Step 3: Book the shipment

Pass the quoteId from the previous step along with your pickup and delivery details. You can add special instructions for each stop.

curl -X POST https://api.wearewarp.com/api/v1/freights/booking \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY" \
  -d '{
    "quoteId": "01HG9W6CMAWHNWTVXDKW9QYFS9",
    "pickupInfo": {
      "zipCode": "90001",
      "city": "Los Angeles",
      "state": "CA",
      "street": "123 Warehouse Blvd",
      "contactName": "Dispatch Team",
      "phone": "3105551234",
      "specialInstruction": "Dock 4, call 30 min before"
    },
    "deliveryInfo": {
      "zipCode": "85001",
      "city": "Phoenix",
      "state": "AZ",
      "street": "456 Distribution Dr",
      "contactName": "Receiving Dock",
      "phone": "6025551234",
      "specialInstruction": "Receiving 7am-3pm"
    },
    "listItems": [{
      "name": "Pallet - Retail Goods",
      "length": 48, "width": 40, "height": 48,
      "sizeUnit": "in",
      "totalWeight": 800, "weightUnit": "lb",
      "quantity": 2,
      "packaging": "pallet"
    }]
  }'

{
  "data": {
    "shipmentId": "shp_01HGA2K9MNPQ4RV8XW3YZ5TJ6",
    "shipmentNumber": "WRP-2026-041542",
    "orderId": "ord_01HGA2K9MNPQ4RV8XW3YZ5TK7",
    "trackingNumber": "WARP1234567890",
    "shipmentType": "LTL",
    "status": "CONFIRMED"
  }
}

The response gives you everything you need: a shipmentId for internal tracking, a trackingNumber for the tracking endpoint, and an orderId for invoices and documents.

Step 4: Track the shipment

Pass one or more tracking numbers to get the current status, location, and full event history for each shipment.

curl -X POST https://api.wearewarp.com/api/v1/freights/tracking \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY" \
  -d '{ "trackingNumbers": ["WARP1234567890"] }'

{
  "data": [{
    "trackingNumber": "WARP1234567890",
    "status": "IN_TRANSIT",
    "currentLocation": {
      "city": "Barstow",
      "state": "CA",
      "timestamp": "2026-04-08T08:42:00Z"
    },
    "estimatedDelivery": "2026-04-09T14:00:00Z",
    "events": [
      {
        "status": "PICKED_UP",
        "location": "Los Angeles, CA",
        "timestamp": "2026-04-07T10:15:00Z",
        "description": "Freight picked up from origin"
      },
      {
        "status": "SCANNED_IN",
        "location": "Los Angeles, CA",
        "timestamp": "2026-04-07T11:30:00Z",
        "description": "Scanned at Warp cross dock"
      },
      {
        "status": "IN_TRANSIT",
        "location": "Barstow, CA",
        "timestamp": "2026-04-08T08:42:00Z",
        "description": "In transit to destination"
      }
    ]
  }]
}

Events include PICKED_UP, SCANNED_IN, IN_TRANSIT, arrivedAtWarehouse, departedFromWarehouse, and DELIVERED, each with timestamps and location data. You can also register webhooks in your dashboard to receive push notifications instead of polling.

Step 5: Get invoices and documents

Once a shipment is complete, pull the invoice and supporting documents using the orderId from your booking confirmation.

The invoices endpoint returns line items, totals, charges, and payment status. The documents endpoint returns URLs for the bill of lading (BOL), proof of delivery (POD), and any other shipment documents.

Ready to integrate?

Use with AI coding tools

Claude Code, Cursor, and other AI coding tools can read Warp's API documentation and generate integration code automatically. Point them at developer.wearewarp.com/docs/freight/ and describe what you need. The AI handles the rest.

The Warp CLI (developer.wearewarp.com/docs/cli) provides the same functionality as shell commands. AI agents running in terminal environments can execute warp quote, warp book, and warp track directly.

Available vehicle types and services

Frequently asked questions