Quotes

Create Quotes

POST /api/v1/quotes

Request multi-carrier rate quotes for a shipment.

Request Body

Field	Type	Required	Description
`origin.city`	string	Yes	Origin city
`origin.state`	string	Yes	2-letter state code
`origin.zip`	string	Yes	ZIP code (5-10 chars)
`origin.company`	string	No	Company name
`origin.contact`	string	No	Contact name
`destination.city`	string	Yes	Destination city
`destination.state`	string	Yes	2-letter state code
`destination.zip`	string	Yes	ZIP code (5-10 chars)
`destination.company`	string	No	Company name
`destination.contact`	string	No	Contact name
`items[].weight`	number	Yes	Weight in lbs
`items[].freight_class`	string	Yes	NMFC freight class
`items[].length`	number	Yes	Length in inches
`items[].width`	number	Yes	Width in inches
`items[].height`	number	Yes	Height in inches
`accessorials.origin_liftgate`	boolean	No	Liftgate at pickup
`accessorials.destination_liftgate`	boolean	No	Liftgate at delivery
`accessorials.inside_pickup`	boolean	No	Inside pickup service
`accessorials.inside_delivery`	boolean	No	Inside delivery service
`accessorials.residential_pickup`	boolean	No	Residential pickup
`accessorials.residential_delivery`	boolean	No	Residential delivery
`accessorials.delivery_appointment`	boolean	No	Appointment delivery
`accessorials.notify_before_delivery`	boolean	No	Call before delivery
`accessorials.sort_and_segregate`	boolean	No	Sort & segregate
`accessorials.hazmat`	boolean	No	Hazardous materials
`customer_id`	number	No	Customer ID to associate

Example

curl -X POST https://api.freightcake.com/api/v1/quotes \
  -H "Authorization: Bearer fk_test_REPLACE_WITH_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": { "city": "Chicago", "state": "IL", "zip": "60601" },
    "destination": { "city": "Atlanta", "state": "GA", "zip": "30301" },
    "items": [{ "weight": 1000, "freight_class": "85", "length": 48, "width": 40, "height": 48 }],
    "accessorials": { "destination_liftgate": true }
  }'

Response

Returns a list of quote objects. All quotes share a quote_group_id.

{
  "object": "list",
  "url": "/api/v1/quotes",
  "data": [
    {
      "object": "quote",
      "id": 1,
      "carrier_name": "Sandbox Freight Co",
      "service_level": "Standard LTL",
      "quote_number": "SBX-001",
      "net_charge_cents": 35000,
      "delivery_estimate": "3-5 business days",
      "origin": { "city": "Chicago", "state": "IL", "zip": "60601" },
      "destination": { "city": "Atlanta", "state": "GA", "zip": "30301" },
      "quote_group_id": "8f6e5c4a-3b2d-41e0-9f87-6a5b4c3d2e10",
      "expires_at": "2026-07-06T00:00:00.000Z",
      "created_at": "2026-07-01T00:00:00.000Z"
    }
  ],
  "has_more": false,
  "quote_group_id": "8f6e5c4a-3b2d-41e0-9f87-6a5b4c3d2e10"
}

List Quotes

GET /api/v1/quotes

Return active quotes for the API key's organization and mode.

Query Parameters

Param	Type	Description
`limit`	number	Max results (1-100, default 10)
`starting_after`	string	Cursor for forward pagination
`ending_before`	string	Cursor for backward pagination

Retrieve Quote

GET /api/v1/quotes/:id

Returns a single quote by ID.

Retrieve Quote Group

GET /api/v1/quotes/group/:groupId

Returns all quotes from a single rate request, sorted by price.

Errors

Status	When
`400`	A location, item, dimension, or freight class is invalid
`404`	The quote or quote group does not exist in the API key's organization or mode
`422`	No enabled carrier can rate the requested shipment

See Handle API Errors for the common error envelope and retry guidance.

On this page