QuoteResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/wearewarp-com/main/json-schema/wearewarp-com-quote-result-schema.json",
  "title": "QuoteResult",
  "x-generated": "2026-10-25",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/wearewarp-com-freight-openapi.json#/components/schemas/QuoteResult",
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string",
      "description": "Unique quote ID (prefixed with W, 27 characters). Use this ID when booking."
    },
    "price": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "number"
        },
        "currency_code": {
          "type": "string"
        }
      }
    },
    "charges": {
      "type": "array",
      "description": "Rate lines. The TOTAL row is price.amount. Every other row is a component: the TRANSIT row is the base freight charge and each SERVICE_OPTION row is an accessorial (its code may also be the carrier-specific accessorial code), so the non-TOTAL rows sum to the TOTAL row. The TRANSIT row is omitted when it cannot be derived so that the rows always reconcile.",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          }
        }
      }
    },
    "transit_time": {
      "type": [
        "number",
        "null"
      ],
      "description": "Predicted transit time in DAYS. `null` when the carrier does not publish a transit duration - FedEx only publishes one for Ground; its Express services (Overnight, 2Day, Express Saver) commit to an absolute date instead, exposed as `estimated_delivery_date`."
    },
    "transit_time_without_team": {
      "type": [
        "number",
        "null"
      ],
      "description": "Transit time in DAYS when the load is driven by a single driver instead of a team. `null` when not applicable."
    },
    "estimated_delivery_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Carrier-committed delivery date (`YYYY-MM-DD`). `null` when the carrier does not commit to a date. For FedEx Express services this is the only delivery estimate available, since `transit_time` is not published for them."
    },
    "expiration_time_utc": {
      "type": "number"
    },
    "status": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "shipmentType": {
      "type": "string",
      "enum": [
        "LTL",
        "FTL",
        "PARCEL"
      ],
      "description": "The shipment type that was priced."
    },
    "insurance": {
      "type": "object",
      "description": "Insurance quote block. Only present when insuranceInfo is provided in the request. Kept separate from price/charges (the freight rate) - it is an independent, optional quote. If the customer opts in, the total payable = price.amount + insurance.total. When the insurance quote fails the block is `{ \"insuranceQuoteId\": null, \"errorMessage\": \"...\" }` and the freight quote is still returned.",
      "properties": {
        "insuranceQuoteId": {
          "type": [
            "string",
            "null"
          ],
          "description": "The insurance quote id. Pass this as insuranceQuoteId when booking to purchase the insurance. `null` when the insurance quote failed (see errorMessage)."
        },
        "premium": {
          "type": "number",
          "description": "The insurance premium."
        },
        "processingFee": {
          "type": "number",
          "description": "The WARP processing fee for insurance."
        },
        "total": {
          "type": "number",
          "description": "Total insurance charge (premium + processingFee)."
        },
        "currency_code": {
          "type": "string"
        },
        "errorMessage": {
          "type": "string",
          "description": "Only present when the insurance quote failed. Explains why (e.g. commodity excluded, insurer unavailable)."
        }
      }
    }
  }
}