All rate guide endpoints require a valid JWT. A token can be generated by sending your
username
and password
in the request body to the POST /api/token/ endpoint.
The new access token should then be included in the Authorization header of the subsequent requests
(e.g. Authorization: JWT <token>
).
Takes a set of user credentials and returns an access and refresh JSON web token pair to prove the authentication of those credentials.
username required | string Username of the user. |
password required | string Password of the user. |
{- "username": "foo",
- "password": "bar"
}
{- "refresh": "string",
- "access": "string"
}
Takes a refresh type JSON web token and returns an access type JSON web token if the refresh token is valid.
refresh required | string Refresh token to fetch new Access token. |
{- "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
{- "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Takes a token and indicates if it is valid. This view provides no information about a token’s fitness for a particular use.
token required | string Access token to be validated. |
{- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
{- "detail": "Token is invalid or expired",
- "code": "token_not_valid"
}
Create a new quote with the required parameters. The quote creation is asynchronous and the quote will be created in the background.
The status can be checked with the /api/quote-requests/{id} endpoint.
It can be either pending
, failed
or ready
.
If ready
, the total price can be read from the 'quote.price' field of the response body.
mode required | string (EquipmentModeEnum) Enum: "FTL" "LTL" Valid equipment modes for the quote. |
equipment_type required | string (EquipmentTypeEnum) Enum: "DRV" "RFR" "FBE" Valid equipment types for the quote. |
weight | string <decimal> expected weight of the load. |
channel required | string Which system originated the quote (for example, the TMS name). |
customer_reference | string Reference for customer tracking |
required | object (QuoteRequirements) Shipment requirements |
required | object (Shipper) Shipper properties |
required | Array of objects (Stop) 2 items [ items ] Pickup and delivery information. If either pickup or delivery dates are unknown, the system will calculate them based on the estimated transit time. If no date is informed, 48h of lead time is assumed. It is preferred to send as many stop details as possible to get a more accurate price. |
Array of objects (ShipmentItem) [ items ] Item information, to track what is being shipped. |
{- "mode": "FTL",
- "equipment_type": "DRV",
- "weight": "string",
- "channel": "string",
- "customer_reference": "string",
- "requirements": {
- "team_driver": true
}, - "shipper": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "stops": [
- {
- "address": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "zipcode": "string",
- "window": {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z"
}, - "drop_trailer": false,
- "accessorials": [
- "string"
]
}, - {
- "address": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "zipcode": "string",
- "window": {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z"
}, - "drop_trailer": false,
- "accessorials": [
- "string"
]
}
], - "items": [
- {
- "po_number": "string",
- "description": "string",
- "hazmat": true,
- "hazmat_class": "EXPLOSIVE_NON_SPECIFIED",
- "ltl_item": {
- "count": 1,
- "height": "string",
- "length": "string",
- "width": "string",
- "weight": "string",
- "destity": "string",
- "stackable": true,
- "nmfc_code": "string",
- "classification": "50",
- "package_type": "std_pallets",
- "ltl_excessive_length_class": "excessive_length_8ft"
}
}
]
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "pending",
- "status_message": "string",
- "error_details": "string",
- "quote": {
- "quote_id": "3c071a1d-db86-46a7-9dc8-72ba3fbca992",
- "quote_number": 0,
- "price": "string",
- "status": "rejected",
- "reject_reason": "string",
- "expires_at": "2019-08-24T14:15:22Z",
- "mode": "FTL",
- "equipment_type": "DRV",
- "weight": "string",
- "mileage": "string",
- "channel": "string",
- "shipper": {
- "name": "string",
- "email": "user@example.com",
- "has_quote_response_integration": true,
- "tms_url": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "customer_reference": "string",
- "requirements": {
- "team_driver": true
}, - "stops": [
- {
- "address": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "zipcode": "string",
- "window": {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z"
}, - "drop_trailer": false,
- "accessorials": [
- "string"
]
}
], - "breakdown": [
- {
- "quoteline_id": "string",
- "type": "string",
- "subtype": "string",
- "label": "string",
- "description": "string",
- "unit_price": "string",
- "quantity": "string",
- "added_by": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "first_name": "string",
- "last_name": "string"
}
}
], - "items": [
- {
- "po_number": "string",
- "description": "string",
- "hazmat": true,
- "hazmat_class": "EXPLOSIVE_NON_SPECIFIED",
- "ltl_item": {
- "count": 1,
- "height": "string",
- "length": "string",
- "width": "string",
- "weight": "string",
- "destity": "string",
- "stackable": true,
- "nmfc_code": "string",
- "classification": "50",
- "package_type": "std_pallets",
- "ltl_excessive_length_class": "excessive_length_8ft"
}
}
], - "selected_rate": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "rates": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "price": "string",
- "status": "open",
- "reject_reason": "string",
- "expires_at": "2019-08-24T14:15:22Z",
- "rate_provider": "external",
- "carrier": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "mc": "string",
- "dot": "string"
}, - "service_level": "string",
- "lane_type": "DIRECT",
- "est_delivery_date": "string",
- "external_id": "string"
}
], - "lead_contact": {
- "name": "string",
- "email": "user@example.com",
- "phone_number": "string",
- "company_name": "string",
- "pickup_address": "string",
- "pickup_instructions": "string",
- "pickup_contact_name": "string",
- "delivery_address": "string",
- "delivery_instructions": "string",
- "delivery_contact_name": "string"
}
}
}
Retrieve the quote-request with the given id.
quote_request_id required | string <uuid> ID of the Quote-Request |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "status": "pending",
- "status_message": "string",
- "error_details": "string",
- "quote": {
- "quote_id": "3c071a1d-db86-46a7-9dc8-72ba3fbca992",
- "quote_number": 0,
- "price": "string",
- "status": "rejected",
- "reject_reason": "string",
- "expires_at": "2019-08-24T14:15:22Z",
- "mode": "FTL",
- "equipment_type": "DRV",
- "weight": "string",
- "mileage": "string",
- "channel": "string",
- "shipper": {
- "name": "string",
- "email": "user@example.com",
- "has_quote_response_integration": true,
- "tms_url": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "customer_reference": "string",
- "requirements": {
- "team_driver": true
}, - "stops": [
- {
- "address": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "zipcode": "string",
- "window": {
- "start": "2019-08-24T14:15:22Z",
- "end": "2019-08-24T14:15:22Z"
}, - "drop_trailer": false,
- "accessorials": [
- "string"
]
}
], - "breakdown": [
- {
- "quoteline_id": "string",
- "type": "string",
- "subtype": "string",
- "label": "string",
- "description": "string",
- "unit_price": "string",
- "quantity": "string",
- "added_by": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "first_name": "string",
- "last_name": "string"
}
}
], - "items": [
- {
- "po_number": "string",
- "description": "string",
- "hazmat": true,
- "hazmat_class": "EXPLOSIVE_NON_SPECIFIED",
- "ltl_item": {
- "count": 1,
- "height": "string",
- "length": "string",
- "width": "string",
- "weight": "string",
- "destity": "string",
- "stackable": true,
- "nmfc_code": "string",
- "classification": "50",
- "package_type": "std_pallets",
- "ltl_excessive_length_class": "excessive_length_8ft"
}
}
], - "selected_rate": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}, - "rates": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "price": "string",
- "status": "open",
- "reject_reason": "string",
- "expires_at": "2019-08-24T14:15:22Z",
- "rate_provider": "external",
- "carrier": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "mc": "string",
- "dot": "string"
}, - "service_level": "string",
- "lane_type": "DIRECT",
- "est_delivery_date": "string",
- "external_id": "string"
}
], - "lead_contact": {
- "name": "string",
- "email": "user@example.com",
- "phone_number": "string",
- "company_name": "string",
- "pickup_address": "string",
- "pickup_instructions": "string",
- "pickup_contact_name": "string",
- "delivery_address": "string",
- "delivery_instructions": "string",
- "delivery_contact_name": "string"
}
}
}
Recommend which carriers within Loadsmart carrier base could be a good candidate to move a load that was quoted in RateGuide. The response will contain up to 20 suggestions ordered by quality. The lower the index in the list, the best is the suggestion.
suggested_carriers.add_carrier_suggestion
) quote_id required | string <uuid> ID of the Quote |
{- "results": [
- {
- "carrier": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "mc": "string",
- "dot": "string"
}, - "drop_rate": "string",
- "choice_criteria": [
- "MOVED_LANE_BEFORE"
]
}
]
}
List of contacts of a given carrier
suggested_carriers.view_carrier_suggestion
) quote_id required | string <uuid> ID of the Quote |
carrier_id required | string <uuid> ID of the Carrier in Loadsmart network |
{- "results": [
- {
- "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
- "first_name": "string",
- "last_name": "string",
- "email": "user@example.com",
- "phone_number": "string",
- "phone_number_extension": "string",
- "feedback": "positive",
- "offers": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "price": "string",
- "type": "email"
}
]
}
]
}
name required | string <= 255 characters The name of the shipper (required when creating a new shipper) |
string or null <email> Shipper's email | |
status | string (Status) Default: "active" Enum: "active" "inactive" |
fuel_rate | number >= 0 The rate per mile to be considered on the fuel surcharge calculation |
has_quote_response_integration | boolean Default: false Indicates if it is possible to send a quote response to the shipper via integration |
tms_url | string <url> Shipper TMS URL |
mileage_provider required | string (MileageProvider) Default: "PCM_CURRENT" Enum: "PCM_CURRENT" "PCM18" "PCM19" "PCM20" "PCM21" "PCM22" "PCM23" "PCM24" "PCM25" "PCM26" "PCM27" "PCM28" "PCM29" "PCM30" "PCM31" "PCM32" "PCM33" "PCM34" "gmaps" Defines which mileage provider will be used when quoting for the given shipper |
{- "name": "string",
- "email": "user@example.com",
- "status": "active",
- "fuel_rate": 0,
- "has_quote_response_integration": false,
- "tms_url": "string",
- "mileage_provider": "PCM_CURRENT"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "email": "user@example.com",
- "status": "active",
- "fuel_rate": 0,
- "has_quote_response_integration": false,
- "tms_url": "string",
- "mileage_provider": "PCM_CURRENT"
}
quotes.view_shipper
) limit | integer (Limit) <= 50 Default: 50 The number of elements to be sent back in a single request. |
offset | integer (Offset) Default: 0 Offset says to skip that many elements |
object or null |
{- "limit": 50,
- "offset": 0,
- "filters": {
- "status": [
- "active"
], - "name": [
- "string"
], - "mileage_provider": [
- "PCM_CURRENT"
], - "id": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
}
{- "count": 0,
- "next": {
- "limit": 0,
- "offset": 0
}, - "previous": {
- "limit": 0,
- "offset": 0
}, - "results": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "email": "user@example.com",
- "status": "active",
- "fuel_rate": 0,
- "has_quote_response_integration": false,
- "tms_url": "string",
- "mileage_provider": "PCM_CURRENT"
}
]
}