Freight

[Experimental] Get all quote options for your shipment

Pull a list of quote options for a potential delivery shipment - every bookable option from every enabled source is returned in options[], cheapest first.<br/><br/>Sources depend on shipmentType: FTL - WARP only; LTL (default) - WARP and the partner LTL carriers; PARCEL - FedEx only. The optional providers query parameter (comma separated, e.g. providers=WARP,Priority1) restricts the sources to a subset of those allowed for your account for that shipment type.<br/><br/>Rate limit: this endpoint counts towards the quoting rate limit of your API key (per UTC hour and per UTC day). Above the limit the API answers 429 rate_limit_exceeded with a Retry-After header.<br/><br/>Request notes: pickupDate is YYYY-MM-DD. This is the only endpoint that returns every parcel service level. For PARCEL every package must respect the FedEx limits: weight per package (totalWeight / quantity) <= 150 lbs, longest side <= 108 in, length + girth (longest side + 2 x (the other two sides)) <= 165 in, and dimensions, weight and quantity must all be > 0. items[].height must be <= 85. Temperature-controlled (reefer) freight is not supported yet: sending temperature_limit is rejected with 400 Reefer Shipment is not supported yet!.<br/><br/>Response notes: transitTime is in seconds; transitTimeWithoutTeam is the transit time with a single driver instead of a team. insurance is only present when insuranceInfo was sent; when the insurance quote fails the block is { "insuranceQuoteId": null, "errorMessage": "..." } and the freight options are still returned. Pass the chosen options[].id as quoteId to POST /freights/book before expirationTs.

post/freights/freight-quote

Request

  • Base URL: https://stg.wearewarp.com/api/v1
  • URL: https://stg.wearewarp.com/api/v1/freights/freight-quote
  • Auth: API key in header apikey

Query parameters

providersstring
Example:WARP,Priority1

(Optional) Comma separated list of quote sources to use (e.g. WARP,Priority1). Only sources allowed for your account and for the shipmentType are used; the others are ignored. Omit to use every allowed source.

Request body

pickupDatestring date required

The earliest pickup date in YYYY-MM-DD format, in the timezone of the pickup stop.

additionalServicesstring[]
shipmentType'LTL' | 'FTL' | 'PARCEL'

Selects the quote sources: FTL is priced by WARP only; LTL (default) by WARP and the partner LTL carriers; PARCEL by FedEx only (every parcel service level is returned as a separate option). PARCEL items must respect the FedEx limits per package: weight per package (totalWeight / quantity) <= 150 lbs, longest side <= 108 in, length + girth <= 165 in; dimensions, weight and quantity must be > 0.

Example request

{
  "pickupDate": "2026-09-20",
  "pickupInfo": {
    "zipcode": "90058",
    "country": "US"
  },
  "deliveryInfo": {
    "zipcode": "90028",
    "country": "US"
  },
  "items": [
    {
      "name": "Item Name",
      "height": 48,
      "length": 48,
      "width": 40,
      "sizeUnit": "IN",
      "totalWeight": 500,
      "weightUnit": "lbs",
      "quantity": 1,
      "packaging": "Pallet",
      "stackable": false,
      "notes": "Notes here"
    }
  ],
  "shipmentType": "LTL",
  "vehicleType": {
    "code": "CARGO_VAN"
  },
  "insuranceInfo": {
    "insuredValue": 20000,
    "commodity": "Electronics"
  }
}

Response

successful creation

idstring

Response ID

requestIdstring

Request ID

Example response

{
  "id": "01HG9W6CKCANZP6J2Q641Q1RTP",
  "requestId": "01HG9W6CKC67HE3DD2TKBVQXX8",
  "options": [
    {
      "source": "WARP",
      "id": "01HG9W6CMAWHNWTVXDKW9QYFS9",
      "carrierCode": "WTCH",
      "carrierName": "Warp Technology",
      "serviceLevel": "STD",
      "name": "FedEx Ground",
      "shipmentType": "LTL",
      "transitTime": 86400,
      "transitTimeWithoutTeam": 172800,
      "estimatedDeliveryDate": "2026-09-03",
      "rate": 85,
      "serviceCharges": [
        {
          "code": "SERVICE_OPTION",
          "description": "liftgate-delivery",
          "amount": 10
        },
        {
          "code": "TRANSIT",
          "description": "Transit Cost",
          "amount": 75
        }
      ],
      "expirationTs": 1701311408778
    }
  ],
  "insurance": {
    "insuranceQuoteId": "01J8ZQ7X8N2R6V5F3C4B9D0E1F",
    "premium": 60,
    "processingFee": 6,
    "total": 66,
    "currency_code": "USD",
    "errorMessage": "Cannot quote insurance at this time."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.