---
title: "Gets an LTL Spot Quote"
method: POST
path: "/api/v1/LTLSpotQuotes"
tags: ["Shipper - Quoting APIs"]
---

# Gets an LTL Spot Quote

`POST /api/v1/LTLSpotQuotes`

Allows Shippers to retrieve a Less-Than-Truckload quote. Given a set of shipment attributes as input, Coyote will 
send back an LTL quote with an LTL spot quote ID (“ltlSpotQuoteId”). This quote includes the list of carriers and 
their respective quotes and is valid for 7 days. If you want to proceed with the quote and book a shipment, 
use our load build request endpoint and specify the Carrier Quote ID.\
*Note: Less-than-Truckload spot quotes are currently unsupported in Europe.\
Same day rate requests will be returned, however pickups may not be accommodated until next day pending carrier availability.*

## Request body

- CoyoteSystemsExternalApiContractsModelsSpotLTLSpotQuoteRequest — LTL Rate Request
  - `origin` CoyoteSystemsExternalApiContractsModelsSpotLtlLocationData, required — City, State and Postal Code required
    - `cityName` string, required — City
    - `stateCode` string, required — State
    - `countryCode` string, required — Country
    - `postalCode` string, required — Postal Code
  - `pickupDate` string, date-time, required — Shipment Pickup Date
  - `originRequirements` CoyoteSystemsExternalApiContractsModelsSpotOriginRequirements — Origin stop requirements
    - `insideStop` boolean — Stop requires Inside Pickup or Delivery
    - `residentialStop` boolean — Residential Stop
    - `tradeshowStop` boolean — Trade show Stop
    - `liftGateStop` boolean — Stop requires Lift Gate
    - `sortSegregate` boolean — Stop requires Sort and Segregate
    - `limitedAccessType` 'Undefined' | 'Church' | 'ConstructionSite' | 'MilitaryBase' | 'MineSite' | 'MiniStorage' | 'RemoteGovtDelivery' | 'School' | 'Other' — LTLLimitedAccessType
  - `destination` CoyoteSystemsExternalApiContractsModelsSpotLtlLocationData, required — City, State and Postal Code required
    - `cityName` string, required — City
    - `stateCode` string, required — State
    - `countryCode` string, required — Country
    - `postalCode` string, required — Postal Code
  - `destinationRequirements` CoyoteSystemsExternalApiContractsModelsSpotDestinationRequirements — Destination stop requirements
    - `appointmentRequired` boolean — Appointment Required
    - `carrierNotifyBeforeArrival` boolean — Carrier Notify Before Arrival
    - `insideStop` boolean — Stop requires Inside Pickup or Delivery
    - `residentialStop` boolean — Residential Stop
    - `tradeshowStop` boolean — Trade show Stop
    - `liftGateStop` boolean — Stop requires Lift Gate
    - `sortSegregate` boolean — Stop requires Sort and Segregate
    - `limitedAccessType` 'Undefined' | 'Church' | 'ConstructionSite' | 'MilitaryBase' | 'MineSite' | 'MiniStorage' | 'RemoteGovtDelivery' | 'School' | 'Other' — LTLLimitedAccessType
  - `equipmentType` 'V' | 'R', required — Equipment Type
  - `commodities` CoyoteSystemsExternalApiContractsModelsSpotCommodity[], required — Commodities
    - `description` string, nullable — Item Description
    - `palletCount` integer, required — Number of pallets relevant to commodity item
    - `freightClass` 'Undefined' | 'N50' | 'N55' | 'N60' | 'N65' | 'N70' | 'N77PT5' | 'N85' | 'N92PT5' | 'N100' | 'N110' | 'N125' | 'N150' | 'N175' | 'N200' | 'N250' | 'N300' | 'N400' | 'N500', required — FreightClass
    - `weight` number, double, required — Pallet weight in lbs
    - `length` number, double, required — Pallet length in inches
    - `height` number, double, required — Pallet height in inches
    - `width` number, double, required — Pallet width in inches
    - `isHazmat` boolean — Is Hazmat Commodity
    - `nmfcNumber` integer, nullable — NMFC Number
    - `nmfcSubNumber` integer, nullable — NMFC Sub
    - `isStackable` boolean — Is the commodity stackable
  - `guaranteedShipment` boolean — Guaranteed Shipment
  - `protectFromFreeze` boolean — Protect From Freeze

## Response `200`

Successfully retrieved LTL Rates

- CoyoteSystemsExternalApiContractsModelsSpotLTLSpotQuote — LTL Rate Response
  - `ltlSpotQuoteId` string, nullable — LTL Spot Quote request Id
  - `carrierQuotes` CoyoteSystemsExternalApiContractsModelsSpotCarrierQuote[], nullable — Carrier Quotes
    - `quoteID` string, nullable — Unique identifier to the quote based on carrier. Specify this ID as the LoadDetail.SpotQuoteId to build a load using the loads endpoint.
    - `carrierName` string, nullable — Name of the carrier
    - `scac` string, nullable — Standard Carrier Alpha Code
    - `currencyType` 'Undefined' | 'USD' | 'CAD' | 'MXN' | 'ARS' | 'BRL' | 'CLP' | 'COP' | 'VEF' | 'EUR' | 'GBP' | 'HUF' | 'PLN' — Currency Type
    - `transitTime` integer — Expected days of transit according to specific carrier
    - `interline` string, nullable — If lane serviced by carrier is Direct or Indirect
    - `deliveryDate` string, date-time — Expected delivery date for shipment Weekends and holidays are excluded
    - `totalRate` number, double — Total rate includes fuel and accessorial services
    - `freightCharge` number, double — Freight Charge
    - `fuelSurcharge` number, double — Fuel Surcharge
    - `accessorialCharges` number, double — Total of accessorial charges
    - `accessorials` CoyoteSystemsExternalApiContractsModelsSpotAccessorial[], nullable — Accessorials
      - `chargeDescription` string, nullable — Accessorial charge description
      - `amount` number, double — Accessorial charge amount

## Other responses

- `204` — No rates found for the origin and destination
- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.dev/coyote/apis/coyotego-api.md) · [All operations](https://skmtc.dev/coyote/apis/coyotego-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coyote/coyotego-api/revisions/3229e1a057a2/schema)
