Get Ocean Carriers API

This section describes the API method to obtain the details of a ocean freight carrier (the companies that service ocean freight) or the list of all carriers. The carrier list is typically only retrieved once, stored internally to your application for use.

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, request the following request will return the list of carriers.

				// Example Request
curl -v -X GET 'https://lclxchange.com/api/carrier' -H "Content-Type: application/json" -H "Authorization: Bearer <access_token>"

On a successful authentication the result will look something like:

				//Example Result
{
"carriers": {
"0": {
"index": 1,
"name": "A.P. Moller-Maersk Group"
},
"1": {
"index": 4,
"name": "China COSCO Shipping"
},
"2": {
"index": 3,
"name": "CMA CGM"
},
"3": {
"index": 5,
"name": "Evergreen Marine"
},
"4": {
"index": 8,
"name": "Hamburg Sud"
},
"5": {
"index": 6,
"name": "Hapag-Lloyd"
},
"6": {
"index": 13,
"name": "Hyundai Merchant Marine"
},
"7": {
"index": 14,
"name": "K Line"
}
}

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

				// Example Request
curl -v -X GET 'https://lclxchange.com/api/carrier' -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
{
"carriers": {
"0": {
"index": 1,
"name": "A.P. Moller-Maersk Group"
}
}
}

An error or invalid credentials will return:

				{
    "Unauthorized": "Access denied."
}
				

API REQUEST DETAILS

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

Component Description
index

The index of the carrier

The URL of the API Services

https://lclxchange.com/api/carrier

Query Parameters

None

HTTP Request Body

A JSON formatted POST request.