--- title: "Retrieve details from a quote request" method: GET path: "/api/v2/quotes-request/{uuid}" tags: ["Quotes"] --- # Retrieve details from a quote request `GET /api/v2/quotes-request/{uuid}` A quote can either be `available`, `rejected`, `expired` or `booked`. If it's available, a price and expiration date will be returned. In the case the quote is rejected, the reason will be detailed in the response. Rejections could be a temporary condition. Retrying the request may or may not provide the caller with an available quote. #### List of possible reject reasons **Note**: we constantly add and remove reject reasons from this list. To make sure the client will continue to work properly in case a new reject reason is added, you can use the message on `reject_description` field to show to users what happened. * forbidden-date: Date is valid but not allowed * price-unavailable: Could not get price * shipper-over-capacity: Shipper over Capacity * lane-not-permitted: Lane not Permitted * shipper-daily-quotes-over-capacity: Shipper daily quotes over capacity * mileage-unavailable: Could not get mileage * next-day-shipment-not-allow: Next day quotes are not allowed * inactive-shipper-daily-quotes-over-capacity: Inactive shipper daily quotes over capacity * weekend-pickup-not-allowed: Pickups are not allowed to happen on weekends * same-day-shipment-not-allow: Same day quote is not allowed * market-size-too-large: Market Size too Large * flatbed-not-allowed: Flatbed not allowed * shipper-profile-is-incomplete: Shipper profile is incomplete ## Path parameters - `uuid` string, uuid, required — Unique Quote Request identifier ## Response `200` Success - object - `data` object, required - `id` string, uuid - `status` string - `reject_reason` string - `mileage` number - `quotes` object[] - `quote_id` string — Reference for the quote that should be used to book the load - `asset_carrier_quote_id` string — Reference for the asset carrier quote. - `expires_at` unknown - `status` 'pending' | 'available' | 'rejected', required - `shipment_mode` string[] - `customer_reference` string — Internal client's reference, such as an ID, of the quote - `service_level` string — A guarantee given by the carrier of deliverying the load on the specified time. Often a higher service level means a higher price - `carriers` object[] - `name` string - `uuid` string, uuid - `priority` 'favorited' | 'restricted' | 'neutral' - `scac` string — Standard Carrier Alpha Code (for `LTL`/`VLTL` quotes only) - `price` object - `total` number - `components` object[] - `type` string - `price` number - `equipment` 'DRV' | 'FBE' | 'RFR' — The type of truck used to transport the shipment. Allowed values are DRV (dry van), FBE (flatbed) and RFR (reefer) - `stops` union[] — Points of interest where the truck makes a stop to either pickup or deliver a shipment. Usually a quote has one pickup stop and one delivery stop, but in some cases there will be multiple delivery stops. - union - object - `type` 'PU' | 'DEL' — The type of the stop, can be PU (Pickup) or DEL (Delivery) - `facility_name` string — Name of the facility at this stop - `contacts` object[] - … - `city` string - `state` string - `address` string - `country` string, required - `zipcode` string, required — 3-letter country code, uppercase (ISO 3166-1 alpha-3) - `window` object[] - … - `instructions` string — Instructions for the driver - object - `type` 'PU' | 'DEL' — The type of the stop, can be PU (Pickup) or DEL (Delivery) - `facility_name` string — Name of the facility at this stop - `contacts` object[] - … - `city` string, required - `state` string, required - `address` string - `country` string, required - `zipcode` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) - `window_start` string, naive date-time, required — A window start indicating the start local time of the truck at the stop (required for first stop) - `window_end` string, naive date-time, required — A window end indicating the end local time of the truck stop at the stop - `instructions` string — Instructions for the driver - `items` object[] - `items_count` union, required — How many of this specific item we will have. This is not the quantity of records in the database. - number - string - `length` union, required — Length of the shipping item - number - string - `width` union, required — Width of the shipping item - number - string - `height` union, required — Height of the shipping item - number - string - `classification` '50' | '55' | '60' | '65' | '70' | '77.5' | '85' | '92.5' | '100' | '110' | '125' | '150' | '175' | '200' | '250' | '300' | '400' | '500', required — Classification representing the Class of the shipping item - `nmfc_code` string — The NMFC Number associated with the shipping item - `package_type` 'std_pallets' | 'pallets_non_std' | 'bags' | 'bales' | 'boxes' | 'bunches' | 'carpets' | 'coils' | 'crates' | 'cylinders' | 'drums' | 'pails' | 'reels' | 'rolls' | 'tubes_pipes' | 'loose' | 'ubox', required — Package type - `hazmat` boolean, required — The commodity being moved consists of hazard material - `hazmat_class` 'explosive_non_specified' | 'mass_explosive' | 'projection_explosive' | 'minor_fire_explosive' | 'minor_explosive' | 'insensitive_mass_explosive' | 'insensitive_minor_explosive' | 'gas_non_specified' | 'flammable_gas' | 'non_flammable_non_poisonous_or_oxygen_gas' | 'poison_gas' | 'flammable_liquid' | 'solid_non_specified' | 'flammable_solid' | 'spontaneously_combustible_solid' | 'dangerous_when_wet' | 'oxidizer_non_specified' | 'oxidizer' | 'organic_peroxide' | 'poison' | 'radioactive' — Hazmat class - `un_number` string — UN numbers are four-digit numbers that identify hazardous materials, and articles in the framework of international transport. - `stackable` boolean, required — Indicates if the item is stackable on the truck - `description` string, required — Name of the commodity that will be shipped - `weight` union, required — The total weight, in pounds, of the shipment. Acceptable values must be positive numbers with up to 2 decimal digits. Any other type will cause a validation error. Note that the minimum value is 1 and the maximum value depends on the chosen equipment_type: 45000 for DRV, 43000 for RFR and 50000 for FBE. If the weight is not provided, it is set to the maximum allowed for the equipment_type. - number - string - `stops` union[] - union - object - `type` 'PU' | 'DEL' — The type of the stop, can be PU (Pickup) or DEL (Delivery) - `facility_name` string — Name of the facility at this stop - `contacts` object[] - `name` string, required — Name of the person who is the contact at this stop - `email` string, email — Email of the contact. Required if no phone number is provided - `phone_number` string — Phone number of the contact. Required if email is provided - `city` string - `state` string - `address` string - `country` string, required - `zipcode` string, required — 3-letter country code, uppercase (ISO 3166-1 alpha-3) - `window` object[] - `start` string, naive date-time — A window start indicating the start local time of the truck at the stop (required for first stop) - `end` string, naive date-time — A window end indicating the end local time of the truck stop at the stop - `instructions` string — Instructions for the driver - object - `type` 'PU' | 'DEL' — The type of the stop, can be PU (Pickup) or DEL (Delivery) - `facility_name` string — Name of the facility at this stop - `contacts` object[] - `name` string, required — Name of the person who is the contact at this stop - `email` string, email — Email of the contact. Required if no phone number is provided - `phone_number` string — Phone number of the contact. Required if email is provided - `city` string, required - `state` string, required - `address` string - `country` string, required - `zipcode` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) - `window_start` string, naive date-time, required — A window start indicating the start local time of the truck at the stop (required for first stop) - `window_end` string, naive date-time, required — A window end indicating the end local time of the truck stop at the stop - `instructions` string — Instructions for the driver - `suggested_mode` 'LTL' | 'PTL' | 'FTL' - `equipments` object[] - `type` 'DRV' | 'FBE' | 'RFR' | 'CON' | 'CUR' | 'DDP' | 'IMC' | 'SDK' | 'STK' | 'BLK' | 'TNK' | 'OTH' — Equipment required to transport the shipment. Recognized equipments are: - DRV: Dry Van - FBE: Flatbed - RFR: Reefer - CON: Conestoga - CUR: Curtainside - DDP: Double Drop - IMC: Intermodal - SDK: Step Deck - STK: Straight truck - BLK: Bulk - TNK: Tanker - OTH: Other equipment not explicited listed - `total_width` number — The load total width expressed in 'ft' - `total_length` number — The load total length expressed in 'ft' - `total_height` number — The load total height expressed in 'ft' - `requirements` object, nullable — Requirements that needs to be fulfilled in order to transport the load - `hazmat` boolean — The commodity being moved consists of hazard material - `tarp` object — If present in 'requirements', it means the shipment needs a tarp - `size` number, float, required — size in expressed in 'ft' - `type` 'lumber' | 'steel' | 'smoke' | 'parachute' | 'machinery' | 'canvas' | 'hay' | 'poly' - `dunnage` boolean — Extra rack added to the truck - `beer` boolean — The carrier must be able to transport alcohool - `teams` boolean — If it requires a team of drivers ## Other responses - `404` — Quote Request not found - `410` — Quote request is no longer available --- [API](https://skmtc.dev/loadsmart/apis/loadsmart-api.md) · [All operations](https://skmtc.dev/loadsmart/apis/loadsmart-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loadsmart/loadsmart-api/revisions/6021c5806fe9/schema)