Download OpenAPI specification:Download
The Rate Quote API provides a standard way to request freight rate quotes for Full Truckload (FTL) shipments. It enables shippers, carriers, and third parties to exchange rate information in a consistent, digitized format, reducing manual processes and improving pricing transparency across the supply chain.
Shippers can submit a single standardized rate quote request and receive responses from one or more carriers, allowing them to compare rates, transit times, and service options without managing carrier-specific integrations.
Carriers can receive rate quote requests in a standard format, simplifying connectivity with a large number of shippers and third parties while reducing onboarding costs and manual quoting processes.
Third parties such as brokers and 3PLs can embed the Rate Quote API into their platforms to retrieve spot and contract rates programmatically, enabling automated load matching and competitive rate shopping.
| customerId | string |
| customerName | string |
required | object (FlexibleDate) |
object (FixedDate) | |
| mode | Array of strings (Transportation Mode) non-empty Items Enum: "FTL" "LTL" "PARCEL" "OCEAN" "AIR" "RAIL" "INTERMODAL" "OTHER" One or more transportation modes for which a rate quote is requested. |
required | Array of objects (Address) >= 2 items |
object (ReferenceNumbers) | |
object (ShipmentTotals) | |
Array of objects (Rating Context Additional Service (Request)) Additional contextual information provided by the requester to communicate specific requirements or considerations for the shipment. This information helps the carrier understand special needs that may result in adjusted rates or additional charges. | |
object (Equipment) | |
object (Payment) |
{- "customerId": "CRN12345",
- "customerName": "Bob",
- "pickupDate": {
- "type": "FLEXIBLE",
- "startDate": "2019-08-24",
- "endDate": "2019-08-24"
}, - "deliveryDate": {
- "type": "FIXED",
- "startDate": "2019-08-24"
}, - "mode": [
- "FTL"
], - "address": [
- {
- "stopType": "Origin",
- "sequenceNumber": 1,
- "name": "Company Name",
- "address1": "123 Main St",
- "address2": "Block 2",
- "city": "Chicago",
- "state": "IL",
- "country": "USA",
- "postalCode": "60601",
- "commodities": [
- {
- "operation": "PICKUP",
- "classification": "50",
- "description": "Electronics",
- "quantity": 10,
- "weight": 500,
- "weightUnit": "Pounds",
- "height": 12,
- "length": 15,
- "width": 10,
- "dimensionsUnit": "Inches",
- "stackable": false,
- "hazardous": false
}
]
}, - {
- "stopType": "Intermediate",
- "sequenceNumber": 2,
- "name": "Company Name",
- "address1": "123 Main St",
- "city": "Roger",
- "state": "AR",
- "country": "USA",
- "postalCode": "72758",
- "commodities": [
- {
- "operation": "PICKUP",
- "classification": "50",
- "description": "Electronics",
- "quantity": 2,
- "weight": 100,
- "weightUnit": "Pounds",
- "height": 5,
- "length": 10,
- "width": 10,
- "dimensionsUnit": "Inches",
- "stackable": false,
- "hazardous": false
}
]
}, - {
- "stopType": "Destination",
- "sequenceNumber": 3,
- "name": "Company Name",
- "address1": "789 Main St",
- "city": "Dallas",
- "state": "TX",
- "country": "USA",
- "postalCode": "75056",
- "commodities": [
- {
- "operation": "DROP",
- "classification": "50",
- "description": "Electronics",
- "quantity": 10,
- "weight": 500,
- "weightUnit": "Pounds",
- "height": 12,
- "length": 15,
- "width": 10,
- "dimensionsUnit": "Inches",
- "stackable": false,
- "hazardous": false
}, - {
- "operation": "DROP",
- "classification": "50",
- "description": "Electronics",
- "quantity": 2,
- "weight": 100,
- "weightUnit": "Pounds",
- "height": 5,
- "length": 10,
- "width": 10,
- "dimensionsUnit": "Inches",
- "stackable": false,
- "hazardous": false
}
]
}
], - "referenceNumbers": {
- "uniqueQuoteReferenceId": "SID9743985",
- "additionalReferences": [
- {
- "name": "Customer Reference Id",
- "value": "CR12345"
}
]
}, - "shipmentTotals": {
- "totalWeight": 500,
- "weightUnit": "Pounds",
- "totalHeight": 50,
- "totalLength": 50,
- "totalWidth": 50,
- "totalPieces": 10,
- "dimensionsUnit": "Inches"
}, - "ratingContextAdditionalServices": [
- {
- "key": "LIFTGATE",
- "context": "Liftgate Service",
- "value": "Y"
}
], - "equipment": {
- "type": [
- "DRYVAN",
- "FLATBED"
], - "temperatureControlled": false,
- "temperatureMin": 0,
- "temperatureMax": 0,
- "tarpRequired": true
}, - "payment": {
- "terms": "Collect",
- "payers": "Consignee"
}
}{- "uniqueQuoteReferenceId": "SID9743985",
- "carrierResult": [
- {
- "mode": "FTL",
- "equipmentType": "DRYVAN",
- "quote": {
- "type": "CONTRACT",
- "id": 12345678,
- "quoteValidFrom": "2026-01-20",
- "quoteValidUntil": "2026-04-20"
}, - "ratingContextAdditionalServices": [
- {
- "key": "LINEHAUL",
- "context": "Line Haul",
- "value": "Y"
}, - {
- "key": "FUEL",
- "context": "Fuel Surcharge",
- "value": "Y"
}, - {
- "key": "LIFTGATE",
- "context": "Liftgate Service",
- "value": "Y"
}
], - "allInclusiveQuote": true,
- "charges": [
- {
- "code": "LINE_HAUL",
- "amount": 1560,
- "currency": "USD"
}, - {
- "code": "FUEL",
- "amount": 536,
- "currency": "USD"
}, - {
- "code": "LIFTGATE",
- "amount": 100,
- "currency": "USD"
}
]
}
], - "messageStatus": {
- "status": "SUCCESS",
- "code": 10000000,
- "message": "Transaction was successful.",
- "resolution": "",
- "information": [
- {
- "code": "string",
- "type": "string",
- "message": "string"
}
]
}
}{- "uniqueQuoteReferenceId": "SID9743985",
- "carrierResult": [
- {
- "mode": "FTL",
- "equipmentType": "DRYVAN",
- "quote": {
- "type": "CONTRACT",
- "id": 12345678,
- "quoteValidFrom": "2026-01-20",
- "quoteValidUntil": "2026-04-20"
}, - "ratingContextAdditionalServices": [
- {
- "key": "LINEHAUL",
- "context": "Line Haul",
- "value": "Y"
}, - {
- "key": "FUEL",
- "context": "Fuel Surcharge",
- "value": "Y"
}, - {
- "key": "LIFTGATE",
- "context": "Liftgate Service",
- "value": "Y"
}
], - "allInclusiveQuote": true,
- "charges": [
- {
- "code": "LINE_HAUL",
- "amount": 1560,
- "currency": "USD"
}, - {
- "code": "FUEL",
- "amount": 536,
- "currency": "USD"
}, - {
- "code": "LIFTGATE",
- "amount": 100,
- "currency": "USD"
}
]
}
], - "messageStatus": {
- "status": "SUCCESS",
- "code": 10000000,
- "message": "Transaction was successful.",
- "resolution": "",
- "information": [
- {
- "code": "string",
- "type": "string",
- "message": "string"
}
]
}
}