Carrier Offer List API

This section describes the API method to obtain the list of offers to ship the requested cargo for each request made by the freight owner. The response will contain the request and the list of offers (if any).

Note: The sample requests contained in this document are for reference only. You will not be able to run the examples as is. Please construct your requests based on your authorization token and data requests with your own data values.

Generating the Request

As an example, the following request will return the list of current and available rate requests from third parties. This list contains the requests that are available for a company to make a competitive offer.

				// Example Request
curl -v -X POST 'https://www.lclxchange.com/api/quote/getoffers' -H "Content-Type: application/json" -H "Authorization: Bearer <access_token>" -d '{ "type" : "all" }'

On a successful authentication the result will look something like:

				//Example Result
{
"offers": {
"0": {
"index": 22,
"cargoname": "BS6yyEDq",
"status": "Available",
"origin": "Hong Kong",
"destination": "Los Angeles",
"needdate": "2019-02-07 00:00:00",
"notes": "A customer has a need to ship 194.1408 cbm of BS6yyEDq to Los Angeles. The requested arrival date for the cargo is 07 Feb 2019",
"qty": 18,
"packingtype": "Piece",
"measureUnit": "m",
"cargowidth": 2.14,
"cargoheight": 1.5,
"cargolength": 3.36,
"massUnit": "kg",
"weight": 297,
"offer": {
"0": {
"offerId": "22",
"offerAmount": 1689,
"currencyId": 52,
"status": "pending"
},
"1": {
"offerId": "21",
"offerAmount": 1710,
"currencyId": 52,
"status": "pending",
"terms": "Rate Validity:\nRate validity is indicated in this tariff.\nAll rates and surcharges are subject to change without prior notice.",
"rates": {
"Chassis Fee": 10.12,
"Ocean Freight": 195
}
}
}
},
"1": {
"index": 21,
"cargoname": "UIxyAplp",
"status": "Available",
"origin": "Hong Kong",
"destination": "Los Angeles",
"needdate": "2019-02-10 00:00:00",
"notes": "A customer has a need to ship 13.09365 cbm of UIxyAplp to Los Angeles. The requested arrival date for the cargo is 10 Feb 2019",
"qty": 15,
"packingtype": "Pallet",
"measureUnit": "m",
"cargowidth": 5.49,
"cargoheight": 5.3,
"cargolength": 0.03,
"massUnit": "kg",
"weight": 102,
"offer": {}
}
}
}

As another example, the request specifying an index will return one carrier result.

				// Example Request
curl -v -X POST 'https://www.lclxchange.com/api/quote/getoffers' -H "Content-Type: application/json" -H "Authorization: Bearer <access_token>" -d '{ "index" : "<index_value>" }'

On a successful authentication the result will look something like:

				//Example Result
{
"offers": {
"0": {
"index": 22,
"cargoname": "BS6yyEDq",
"status": "Available",
"origin": "Hong Kong",
"destination": "Los Angeles",
"needdate": "2019-02-07 00:00:00",
"notes": "A customer has a need to ship 194.1408 cbm of BS6yyEDq to Los Angeles. The requested arrival date for the cargo is 07 Feb 2019",
"qty": 18,
"packingtype": "Piece",
"measureUnit": "m",
"cargowidth": 2.14,
"cargoheight": 1.5,
"cargolength": 3.36,
"massUnit": "kg",
"weight": 297,
"offer": {
"0": {
"offerId": "22",
"offerAmount": 148,
"currencyId": 52,
"status": "pending"
},
"1": {
"offerId": "21",
"offerAmount": 145,
"currencyId": 52,
"status": "pending"
}
}
}
}
}

API REQUEST DETAILS

This section provides information about what is required to generate an offer API Request. These fields populate the JSON request.

GET POST Component Description
index

The index of the target offer to return

type

The type of results to return use keyword (all, offers, sel, nsel):

all(default) - show all results
offers - show quote requests with an offer
sel - show the selected quote requests
nsel - show the not selected quote requests

offset

The page offset starting at 0

rowsperpage

The number of results to return per page, this value must be included with offset

The URL of the API Services

https://www.lclxchange.com/api/quote/getoffers

Query Parameters

None

HTTP Request Body

A JSON formatted POST request.