---
title: "Gets a TL Spot Quote"
method: POST
path: "/api/v1/SpotQuotes"
tags: ["Shipper - Quoting APIs"]
---

# Gets a TL Spot Quote

`POST /api/v1/SpotQuotes`

Allows Shippers to retrieve a Truckload quote. Given a set of shipment attributes as input, Coyote will send back a 
quote with a spot quote ID (“spotQuoteId”). This quote includes fuel, unless otherwise specified at the time of integration, 
and will be valid for 5 hours. If you want to proceed with the quote and book a shipment, use our load build request endpoint.\
*Note: Truckload spot quotes are currently unsupported in Europe.*

## Request body

- CoyoteSystemsExternalApiContractsModelsSpotSpotQuoteRequest — Spot Quote Request
  - `equipmentTypeId` 'V' | 'R', required — Equipment Type
  - `origin` CoyoteSystemsExternalApiContractsModelsSpotLocationData, required — City, State and Postal Code required
    - `cityName` string, required — City
    - `stateCode` string, required — State
    - `countryCode` string, nullable — Country (optional)
    - `postalCode` string, required — Postal Code
  - `destination` CoyoteSystemsExternalApiContractsModelsSpotLocationData, required — City, State and Postal Code required
    - `cityName` string, required — City
    - `stateCode` string, required — State
    - `countryCode` string, nullable — Country (optional)
    - `postalCode` string, required — Postal Code
  - `pickUpDateUTC` string, date-time, required — Load Pickup Date UTC
  - `minTemperature` number, double, nullable — Minimum Temperature (required if Equipment Type = R)
  - `maxTemperature` number, double, nullable — Maximum Temperature (required if Equipment Type = R)
  - `weight` number, double, nullable — Weight
  - `commodity` string, nullable — Commodity
  - `equipmentLength` number, double, nullable — Equipment Length
  - `isHazmat` boolean, nullable — Load is Hazmat __(currently unsupported)__
  - `isDropTrailer` boolean, nullable — Load Requires Drop Trailer __(currently unsupported)__
  - `customerShipmentId` string, required — Shipment ID

## Response `200`

The spot quote was successfully retrieved

- CoyoteSystemsExternalApiContractsModelsSpotSpotQuote — SpotQuote
  - `spotQuoteId` integer — SpotQuoteId - Specify this ID as the LoadDetail.SpotQuoteId to build a load using the loads endpoint.
  - `customerShipmentId` string, nullable — CustomerShipmentId
  - `origin` CoyoteSystemsExternalApiContractsModelsSpotLocationData — City, State and Postal Code required
    - `cityName` string, required — City
    - `stateCode` string, required — State
    - `countryCode` string, nullable — Country (optional)
    - `postalCode` string, required — Postal Code
  - `destination` CoyoteSystemsExternalApiContractsModelsSpotLocationData — City, State and Postal Code required
    - `cityName` string, required — City
    - `stateCode` string, required — State
    - `countryCode` string, nullable — Country (optional)
    - `postalCode` string, required — Postal Code
  - `equipmentTypeId` 'V' | 'R' — Equipment Type
  - `pickUpDateUTC` string, date-time — PickupDateUTC
  - `validUntilUtc` string, date-time — ValidUntilUtc
  - `totalRate` number, double — TotalRate __Total rate includes fuel__
  - `rateLineItems` CoyoteSystemsExternalApiContractsModelsSpotRateItem[], nullable — List of rate items that make up the total rate for this quote
    - `rateCode` 'Unknown' | 'FlatRate' | 'FuelSurcharge' — Charge codes: FR = FlatRate, 405 = FuelSurCharge, PM = PerMile
    - `description` string, nullable — Rate code description
    - `unitRate` number, double — Unit amount of the rate line item.
    - `units` number, double — Number of Units
    - `totalRate` number, double — Total amount of the rate line item.
    - `currency` 'USD' | 'CAD' — Currency types

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden

---

[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)