Freight Spot Quote

Obtain a spot price quote for a freight shipment. Spot quotes are typically discounted rates based on excess carrier capacity vs contractual rates. The carrier will return the service level they are able to offer as opposed to specifying the desired service level in the request.

Note: in terms of user workflow for spot quotes, the expectation is that the quote ID coming back from the carrier is included on the BOL they provide the carrier at the time of pickup, allowing the carrier to match the shipment to the original quote and invoice it correctly. Additionally, as spot quotes can expire, if the quote has expired at the time of pickup a new spot quote should be created to include in the BOL.

SecurityFreightApiCode

Request

Request Body schema: application/json

transaction_id required	string
scac required	string The NMFTA Standard Carrier Alpha Code is used to identify a freight carrier within the transportation industry.
auth	object The carrier authorization information needed to fulfill this request.
required	object
required	Array of objects (Container)
required	object The dimensions and weight consumed by the shipment once loaded in the trailer
	Array of objects (AccessorialService) Accessorial services required for delivery
required	object
required	object
required	object (BillingParty)
required	object (RequestingParty)

Responses

200

400

Bad Request

429

Too Many Requests

500

Internal Server Error

520

External Server Error

post/freight-spot-quote

Request samples

Payload

application/json

{"transaction_id": "string",
"scac": "string",
"auth": { },
"pickup": {"date": "2019-08-24"
},
"containers": [{"code": "string",
"freight_class": 50,
"nmfc_code": "string",
"description": "Windows",
"dimensions": {"width": 0,
"height": 0,
"length": 0,
"unit": "inches"
},
"weight": {"value": 0,
"unit": "grams"
},
"quantity": 0,
"stackable": true,
"hazardous_materials": true
}
],
"shipment_measurements": {"total_linear_length": {"value": 0,
"unit": "inches"
},
"total_width": {"value": 0,
"unit": "inches"
},
"total_height": {"value": 0,
"unit": "inches"
},
"total_weight": {"value": 0,
"unit": "grams"
}
},
"accessorials": [{"code": "string",
"attributes": { }
}
],
"ship_from": {"account": "string",
"address": {"company_name": "string",
"address_lines": ["string"
],
"city_locality": "string",
"state_province": "string",
"postal_code": "string",
"country_code": "string",
"residential": false
}
},
"ship_to": {"account": "string",
"address": {"company_name": "string",
"address_lines": ["string"
],
"city_locality": "string",
"state_province": "string",
"postal_code": "string",
"country_code": "string",
"residential": false
}
},
"bill_to": {"type": "consignee",
"payment_terms": "collect",
"account": "string",
"address": {"company_name": "string",
"address_lines": ["string"
],
"city_locality": "string",
"state_province": "string",
"postal_code": "string",
"country_code": "string",
"residential": false
},
"contact": {"name": "string",
"phone_number": "string",
"email": "string"
}
},
"requested_by": {"company_name": "string",
"contact": {"name": "string",
"phone_number": "string",
"email": "string"
}
}
}

Response samples

application/json

{"transaction_id": "string",
"scac": "string",
"results": [{"service_level": {"carrier_description": "string"
},
"quote": {"id": "string",
"effective": {"date": "2019-08-24"
},
"expiration": {"date": "2019-08-24"
},
"carrier_message": "string"
},
"pickup": {"date": "2019-08-24"
},
"delivery": {"estimated": {"days": 0
}
},
"charges": [{"type": "total",
"description": "Lift gate required at delivery",
"amount": {"value": "string",
"currency": "string"
}
}
],
"warnings": [{"external_code": "string",
"message": "string"
}
]
}
]
}