LTL Rates API
Introduction to the LTL Rates API. Use these endpoints to manage LTL Rates.
Get LTL Rates
Details about get an LTL Rates. Include request/response examples, required fields, and validation rules here.
POST /tmsapi/getLTLQuotes HTTP/1.1
Host: https://devdemov1.shipmentx.com
Authorization: Bearer <Token>Request:
{
"sender_id": "SXUSAWD",
"sender_details": {
"name": "John Doe",
"company_name": "ABC Logistics",
"contact_number": "1234567890",
"email": "john.doe@abclogistics.com",
"address": "123 Main Street",
"city": "Fremont",
"state": "CA",
"postalCode": "94539",
"countryCode": "US"
},
"pickupDate": "2024-12-19",
"cargoType": "General Goods",
"carrier": "FedEx",
"handling_unit": [
{
"length": "100",
"width": "100",
"height": "100",
"weight": "100",
"quantity": "2",
"freight_class": "500",
"handlingvolume": "1000000",
"handlingunit": "1"
}
],
"source": {
"location_name": "Warehouse A",
"contact_name": "Alice Johnson",
"contact_number": "9876543210",
"email": "alice.johnson@warehouse.com",
"streetLanes": "456 Industrial Lane",
"city": "Fremont",
"state": "CA",
"postalCode": "94539",
"countryCode": "US"
},
"destination": {
"location_name": "Distribution Center B",
"contact_name": "Bob Smith",
"contact_number": "1122334455",
"email": "bob.smith@distribution.com",
"streetLanes": "789 Logistics Blvd",
"city": "Dallas",
"state": "TX",
"postalCode": "75251",
"countryCode": "US"
}
}| Parameter | Type | Position | # | Description |
|---|---|---|---|---|
| Authorization | String |
Header |
@Required |
Authorization: Bearer {TOKEN_HERE} |
| sender_id | String/Numeric |
Body |
@Required |
Sender Identification Number |
| sender_details | Object |
Body |
@Required |
Sender details including name, company, contact, email, and address |
| pickupDate | String (YYYY-MM-DD) |
Body |
@Required |
Scheduled pickup date |
| cargoType | String |
Body |
@Optional |
Type of cargo being shipped |
| carrier | String |
Body |
@Optional |
Carrier responsible for transportation |
| handling_unit | Array of Objects |
Body |
@Required |
Details about handling units including dimensions, weight, quantity, freight class |
| source | Object |
Body |
@Required |
Source location details including name, contact, address, and city |
| destination | Object |
Body |
@Required |
Destination details including name, contact, address, and city |
Response:
Success code: 200{
"status": true,
"message": "LTL Quote request processed successfully.",
"data": [
{
"id": "8786",
"req_data_id": "2956",
"total_charge": "284.170",
"transit_days": "1",
"service_type": "UPS standard freight",
"vendor_id": "4",
"carrier_code": "",
"carrier_name": "",
"breakdown": [
{
"addon_name": "Haul Amount",
"addon_price": "182.00"
},
{
"addon_name": "FUEL CHARGE",
"addon_price": "77.17"
},
{
"addon_name": "HICST",
"addon_price": "25.00"
}
]
},
{
"id": "8781",
"req_data_id": "2956",
"total_charge": "382.110",
"transit_days": "47",
"service_type": "Roadrunner Transportation",
"vendor_id": "11",
"carrier_code": "166297679",
"carrier_name": "Roadrunner Transportation",
"breakdown": [
{
"addon_name": "Rated As values",
"addon_price": "780.35"
},
{
"addon_name": "California Compliance Charge",
"addon_price": "60.00"
},
{
"addon_name": "Linehaul Surcharge",
"addon_price": "51.35"
},
{
"addon_name": "Fuel Surcharge - 32.85%",
"addon_price": "51.27"
},
{
"addon_name": "Item Charge",
"addon_price": "0.00"
},
{
"addon_name": "Discount - 80.00%",
"addon_price": "-624.28"
}
]
},
{
"id": "8782",
"req_data_id": "2956",
"total_charge": "585.580",
"transit_days": "47",
"service_type": "XPO Freight",
"vendor_id": "11",
"carrier_code": "536697983",
"carrier_name": "XPO Freight",
"breakdown": [
{
"addon_name": "Item Charge",
"addon_price": "646.81"
},
{
"addon_name": "FUEL SURCHARGE 29.75%",
"addon_price": "106.25"
},
{
"addon_name": "Deficit Charge",
"addon_price": "86.54"
},
{
"addon_name": "CALIFORNIA COMPLIANCE SURCHARGE",
"addon_price": "25.00"
},
{
"addon_name": "Discount",
"addon_price": "-376.21"
}
]
},
{
"id": "8783",
"req_data_id": "2956",
"total_charge": "724.480",
"transit_days": "47",
"service_type": "XPO Freight",
"vendor_id": "11",
"carrier_code": "536697983",
"carrier_name": "XPO Freight",
"breakdown": [
{
"addon_name": "Item Charge",
"addon_price": "646.81"
},
{
"addon_name": "Guaranteed Rate",
"addon_price": "115.85"
},
{
"addon_name": "FUEL SURCHARGE 29.75%",
"addon_price": "106.25"
},
{
"addon_name": "Deficit Charge",
"addon_price": "86.54"
},
{
"addon_name": "CALIFORNIA COMPLIANCE SURCHARGE",
"addon_price": "25.00"
},
{
"addon_name": "Discount",
"addon_price": "-376.21"
}
]
},
{
"id": "8784",
"req_data_id": "2956",
"total_charge": "1529.120",
"transit_days": "47",
"service_type": "Old Dominion Freight Lines",
"vendor_id": "11",
"carrier_code": "988326969",
"carrier_name": "Old Dominion Freight Lines",
"breakdown": [
{
"addon_name": "Item Charge",
"addon_price": "5468.85"
},
{
"addon_name": "Fuel Surcharge",
"addon_price": "268.94"
},
{
"addon_name": "CALIFORNIA COMPLIANCE SURCHARGE",
"addon_price": "22.00"
},
{
"addon_name": "Discount: 82.00",
"addon_price": "-4484.46"
}
]
},
{
"id": "8785",
"req_data_id": "2956",
"total_charge": "1904.800",
"transit_days": "47",
"service_type": "Old Dominion Freight Lines",
"vendor_id": "11",
"carrier_code": "988326969",
"carrier_name": "Old Dominion Freight Lines",
"breakdown": [
{
"addon_name": "Item Charge",
"addon_price": "5468.85"
},
{
"addon_name": "Guaranteed",
"addon_price": "313.33"
},
{
"addon_name": "Fuel Surcharge",
"addon_price": "268.94"
},
{
"addon_name": "CALIFORNIA COMPLIANCE SURCHARGE",
"addon_price": "22.00"
},
{
"addon_name": "Discount: 82.00",
"addon_price": "-4484.46"
}
]
}
]
}{
"results": [],
"error": {
"message": "Not authorized to access resource",
"details": "Not authorized"
}
}