---
title: "get quote histories"
method: GET
path: "/freights/quote-history"
tags: ["Freight"]
---

# get quote histories

`GET /freights/quote-history`

## Request

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

Returns your previous quote requests, newest first. Invalid `limit` / `offset` values are rejected with 400 `invalid_field_data`.

## Query parameters

- `limit` number
- `offset` number
- `pickupDate` string
- `pickupZipcode` string
- `deliveryZipcode` string

## Response `200`

successful operation

- QuoteHistory[]
  - `requestId` string
  - `responseId` string
  - `pickupDate` string
  - `pickupInfo` object
    - `zipcode` string
  - `deliveryInfo` object
    - `zipcode` string
  - `pickupServices` string[]
  - `deliveryServices` string[]
  - `additionalServices` string[]
  - `items` BookShipmentItem[]
    - `name` string
    - `height` number, required: Maximum 108 on POST /freights/booking; maximum 85 on POST /freights/freight-quote, /freights/book and the multi-stops endpoints (checked on the raw value, whatever the sizeUnit).
    - `length` number, required
    - `width` number, required
    - `sizeUnit` 'IN' | 'FT', required
    - `totalWeight` number, required
    - `weightUnit` 'lbs' | 'kgs', required
    - `quantity` integer, required
    - `packaging` string: Packaging unit of the line item (e.g. Pallet). Defaults to Pallet.
    - `temperature_limit` object: Temperature-controlled (reefer) freight is NOT supported yet by the quote endpoints: POST /freights/quote rejects any non-zero min/max and POST /freights/freight-quote rejects the field entirely with 400 `Reefer Shipment is not supported yet!`. Omit this field unless instructed otherwise by WARP.
      - `min` number: Minimum temperature.
      - `max` number: Maximum temperature.
    - `stackable` boolean
    - `notes` string
    - `freightClass` string: NMFC freight class of the line item (e.g. 70).
    - `barcodes` string[]
  - `options` QuoteOption[]
    - `source` 'WARP' | 'Priority1' | 'WWEX' | 'Exfreight' | 'FFE' | 'ESTES' | 'DAT' | 'FedEx': Source of Quote Option (WARP network or a partner carrier).
    - `id` string: Quote ID to be used for subsequent booking.
    - `carrierCode` string: SCAC code of the carrier
    - `carrierName` string: Name of the carrier
    - `serviceLevel` string: Service level provided by carrier for the corresponding quote option
    - `name` string: Display name of the option (e.g. the FedEx service name for PARCEL options). Omitted when the source does not provide one.
    - `shipmentType` 'LTL' | 'FTL' | 'PARCEL': Type of delivery shipment
    - `transitTime` integer, nullable: Predicted Transit Time in seconds. Returned as `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 `estimatedDeliveryDate`.
    - `transitTimeWithoutTeam` integer, nullable: Predicted transit time in seconds when the load is driven by a single driver instead of a team. Returned as `null` when not applicable.
    - `estimatedDeliveryDate` string, date: Carrier-committed delivery date (`YYYY-MM-DD`). Omitted when the carrier does not commit to a date. For FedEx Express services this is the only delivery estimate available, since `transitTime` is not published for them.
    - `rate` number, double: Total rate for this option (base freight + accessorials). Equals the sum of serviceCharges.
    - `serviceCharges` unknown[]: Rate lines making up `rate`: the TRANSIT row is the base freight charge and each SERVICE_OPTION row is an accessorial, so the amounts sum to `rate`. The TRANSIT row is omitted when it cannot be derived so that the rows always reconcile.
      - unknown
    - `expirationTs` integer: Expiration time in Epoch Milliseconds

## Other responses

- `400`: Bad Request - the request payload is missing fields or contains invalid data.
- `401`: Unauthorized - the apikey header is missing or does not match any active API key.
- `403`: Forbidden - the customer account is suspended. The body carries `message` only, without `code`.
- `429`: Too Many Requests - the quoting rate limit of the API key was exceeded (only POST /freights/quote, /freights/freight-quote and /freights/quote/multi-stops are rate limited; limits apply per UTC hour and per UTC day). The `Retry-After` header holds the number of seconds until the window resets.
- `500`: Internal Server Error - an unknown error has occurred.

---

[API](https://skmtc.dev/wearewarp/apis/warp-api-documentation.md) · [All operations](https://skmtc.dev/wearewarp/apis/warp-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/wearewarp/apis/warp-api-documentation/revisions/01526741bb48?raw)