This document describes the Logistics Explorer API web service. Our API documentation allows to calculate FCL, FTL rates and port fees.
| URL | https://sirius.searates.com/port/api-fcl?parameters |
| HTTP Method | GET |
| Output Format | JSON |
Input Parameters
| Parameter name | Required | Type | Description |
apiKey | yes | string | API key: hexadecimal number |
lat_from | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lng_from | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lat_to | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
lng_to | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
route_info | no | bool | Show ports details and sea route. The available values for this parameter are: true | false
Default value: false |
Example URL
https://sirius.searates.com/port/api-fcl?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=-19.85&lng_to=-56.8843 The above query returns the following result:
{
"rates":{
"fcl":[
{
"id":448479,
"20st":"1500",
"40st":"2600",
"40hq":"2600",
"currency":"USD",
"sealine":"MAERSK",
"thc_exp":true,
"thc_imp":false,
"fee_exp":false,
"fee_imp":false,
"valid_date_from":"2016-10-23",
"valid_date_to":"2018-11-02",
"transit_time":"26 days 11 hours"
},
{
"id":24208,
"20st":"1550",
"40st":"2800",
"40hq":"2800",
"currency":"USD",
"sealine":null,
"thc_exp":false,
"thc_imp":false,
"fee_exp":false,
"fee_imp":false,
"valid_date_from":"2017-04-01",
"valid_date_to":"2018-11-02",
"transit_time":"26 days 11 hours"
}
],
"road_from":{
"rate":1579.5634,
"currency":"USD"
},
"road_to":{
"rate":975.3110992,
"currency":"USD"
},
"port_fees_from":[
[
"ADE",
"Agency Documentation Fee Exports",
30,
true
],
[
"ERI",
"Ecological and Radiological Service",
15,
false
],
[
"EXP",
"Export Service",
120,
false
],
[
"FFC",
"Forwarder Commission - Origin",
35,
false
],
[
"HDL",
"Lift On Lift Off Service",
36,
false
],
[
"IHW",
"Inland Haulage Container Weighing",
10,
false
],
[
"ODF",
"Documentation Fee - Origin",
25,
true
],
[
"PAE",
"Port Additionals \/ Port Dues - Export",
27,
false
],
[
"ULE",
"Agency Logistics fee export",
26,
false
],
[
"OTHC",
"Original Terminal Handling Charge",
330,
false
]
],
"port_fees_to":[
[
"ADI",
"Agency Documentation Fee imports",
30,
true
],
[
"ERI",
"Ecological and Radiological Service",
15,
false
],
[
"IHW",
"Inland Haulage Container Weighing",
10,
false
],
[
"IMP",
"Import Service",
25,
false
],
[
"PAI",
"Port Additionals \/ Port Dues - Import",
20,
false
],
[
"ULI",
"Agency Logistic Fee Import",
25,
false
],
[
"DTHC",
"Destination Terminal Handling Charge",
200,
false
]
]
}
}
This document describes the Logistics Explorer API web service. Our API documentation allows to calculate LCL, LTL rates and port fees.
| URL | https://sirius.searates.com/port/api-lcl?parameters |
| HTTP Method | GET |
| Output Format | JSON |
Input Parameters
| Parameter name | Required | Type | Description |
apiKey | yes | string | API key: hexadecimal number |
lat_from | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lng_from | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lat_to | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
lng_to | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
weight | yes | integer | Weight of cargo in kg |
volume | yes | integer | Volume of cargo in CBM |
Example URL
https://sirius.searates.com/port/api-lcl?apiKey=XXXXXXXXXXX&lat_from=24.8607343&lng_from=67.00113639999995&lat_to=46.482526&lng_to=30.723309500000028&weight=1000&volume=1 The above query returns the following result:
{
"rates": {
"lcl": {
"rate": "135",
"currency": "USD",
"id": 43989,
"valid_date_to": "2018-12-30"
},
"road_from": {
"rate": 400,
"currency": "USD"
},
"port_fees_from": [
[
"ADE",
"Agency Documentation Fee Exports",
30,
true
],
[
"OTHC",
"Original Terminal Handling Charge",
35000,
true
],
[
"PAE",
"Port Additionals / Port Dues - Export",
25000,
true
]
],
"port_fees_to": [
[
"ADI",
"Agency Documentation Fee imports",
30,
true
],
[
"DTHC",
"Destination Terminal Handling Charge",
35000,
true
],
[
"PAI",
"Port Additionals / Port Dues - Import",
25000,
true
]
],
"road_to": {
"rate": 75,
"currency": "USD"
}
}
}
| URL | https://sirius.searates.com/port/api-path?parameters |
| HTTP Method | GET |
| Output Format | JSON |
Input Parameters
| Parameter name | Required | Type | Description |
apiKey | yes | string | API key: hexadecimal number |
lat_from | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lng_from | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lat_to | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
lng_to | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
Example URL
https://sirius.searates.com/port/api-path?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=-19.85&lng_to=-56.8843 The above query returns the following result:
{
"route":{
"dist":"12419.73",
"path":"{30.730773925781,46.5,30.758972167969,46.511625395438,30.758972167969,46.511625395438,30.819396972656,46.489883541007,30.824680505371,46.436555936107,30.725116906737,46.325475946741,30.627136230469,46.031140184419,29.170074462891,41.24693139645,29.114791375445,41.207973198788,29.083213806152,41.179974225999,29.063816070557,41.159340583766,29.065532684326,41.141140050304,29.080123901367,41.123971420422,29.065189361572,41.107822223054,29.060039520264,41.098017190186,29.061069488525,41.083166269863,29.058236792072,41.078189908522,29.051284790039,41.075542531793,29.046478271484,41.055129637182,29.03720659179,41.045562554137,28.9956665039062,41.0279874522154,28.990516662598,41.005552688238,28.97970199585,40.997131818177,28.8253784179687,40.9355032692388,27.755584716797,40.682736808636,27.6058959960937,40.6782481004625,27.510417027466,40.658097138288,27.038726806641,40.511938422534,26.671497438554,40.387408651504,26.646613683123,40.351561119488,26.444778442383,40.215661531379,26.402200445953,40.205212692524,26.385725911029,40.190560952963,26.389846801758,40.153400004175,26.382293701172,40.120911946181,26.187286376953,40.020219765046,26.0293579101562,39.9425078669945,25.845336914062,39.769806795985,25.751953125,39.1987067162206,24.724731445312,38.089639545062,24.617614746094,37.926483748102,24.1067504882812,37.6284683104105,23.238830566406,36.412332468029,23.047106120104,36.392147728936,22.813838339935,36.43459603504,22.632945446366,36.360312733004,22.403869628906,36.360454655144,15.049896240234,36.601196658744,14.78759765625,36.658504568975,14.694900512695,36.685490639009,14.444274902344,36.736683064731,11.041259765625,37.212636777713,9.8794555664062,37.473139366222,9.7942663382033,37.470283298339,6.46545410156247,37.1513656074632,5.0015258789062,37.031211189637,3.9454650878906,36.981797063198,3.7566328517775,36.959304077708,2.9592386402107,36.896153771838,0.917358398437467,36.5809766665745,0.1043701171875,36.221381657439,-0.43121337890625,35.991340960635,-1.1041259765625,35.815250169427,-2.9406722739757,35.502687650191,-5.2823638916016,35.944781116016,-5.5055236816406,35.939203883606,-5.73486328125,35.895181682182,-6.0562133789062,35.826408901004,-8.5171508789062,33.351877730188,-8.7451171875,33.152326302774,-9.2999267578125,32.653250879969,-9.3521118164062,32.500496489245,-9.42626953125,32.277844514983,-13.317916482157,27.986870923857,-14.466664246448,26.486352757578,-16.111450195313,24.024745076322,-17.369384765625,21.48245191885,-34.702483585103,-8.4600260964326,-39.088855814875,-19.437603281259,-40.370243255206,-22.453189631559,-42.046051025391,-23.101207389715,-44.478149414062,-23.812789391972,-45.259643588603,-24.139333404224,-48.290405273438,-25.624192441212,-48.33366394043,-25.613047870816,-48.345336914062,-25.546778150624,-48.371429443359,-25.529430487502,-48.398895263672,-25.53314805514,-48.414688110352,-25.542441470125,-48.444900512695,-25.538104632759,-48.472366333008,-25.530669689516,-48.472366333008,-25.530669689516,-48.507385253906,-25.554053711007}",
"st":1,
"port_name_from":"Odessa",
"port_country_from":"UA",
"port_name_to":"Paranagua",
"port_country_to":"BR",
"locode_from":"UAODS",
"locode_to":"BRPNG"
}
}
This document describes the Logistics Explorer API web service. Our API documentation allows to calculate Air rates and port fees.
| URL | https://sirius.searates.com/port/api-air?parameters |
| HTTP Method | GET |
| Output Format | JSON |
Input Parameters
| Parameter name | Required | Type | Description |
apiKey | yes | string | API key: hexadecimal number |
lat_from | yes | float number | The latitude value specifying the location for which you wish to obtain the closest air port of loading. |
lng_from | yes | float number | The longitude value specifying the location for which you wish to obtain the closest air port of loading. |
lat_to | yes | float number | The latitude value specifying the location for which you wish to obtain the closest air port of discharge. |
lng_to | yes | float number | The longitude value specifying the location for which you wish to obtain the closest air port of discharge. |
weight | yes | float number | Weight of cargo in tons |
Example URL
https://sirius.searates.com/port/api-air?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=40.7127753&lng_to=-74.0059728&weight=0.3 The above query returns the following result:
{
"rates":{
"road_from":{
"name":"Boryspil Intl",
"lat":50.344999999999998863131622783839702606201171875,
"lng":30.8947220000000015716068446636199951171875,
"country":"UA",
"rate":29,
"profile":472173,
"company_name":"SeaRates LTD",
"path":"Kyiv - Odesa"
},
"road_to":{
"name":"Wall Street Heliport",
"lat":40.70121400000000022600943339057266712188720703125,
"lng":-74.00902800000000070212990976870059967041015625,
"country":"UA",
"rate":13,
"profile":472173,
"company_name":"SeaRates LTD",
"path":"Florida - Texas"
},
"air":[
{
"export":[
[
"EXP",
"Export Service",
90,
true,
471971,
"SeaRates LTD",
"MT"
],
[
"ODF",
"Documentation Fee - Origin",
80,
true,
471971,
"SeaRates LTD",
"MT"
]
],
"import":[
[
"DDF",
"Documentation Fee - Destination",
80,
true,
1,
"SeaRates LTD",
"MT"
],
[
"IMP",
"Import Service",
90,
true,
1,
"SeaRates LTD",
"MT"
]
],
"id":285529,
"profile":1,
"user":1,
"profile_chat":1,
"company_name":"SeaRates LTD",
"country":"MT",
"indicative":null,
"line_id":0,
"al_name":"Indicative",
"term":"",
"comment":null,
"fav":false,
"transit_time":null,
"valid_date_to":"2018-12-07",
"rate":1110
}
]
}
}
This document describes the Logistics Explorer API web service. Our API documentation allows to calculate Rail rates and port fees.
| URL | https://sirius.searates.com/port/api-rail?parameters |
| HTTP Method | GET |
| Output Format | JSON |
Input Parameters
| Parameter name | Required | Type | Description |
apiKey | yes | string | API key: hexadecimal number |
lat_from | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lng_from | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lat_to | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
lng_to | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
Example URL
https://sirius.searates.com/port/api-rail?apiKey=XXXXXXXXXXX&lat_from=50.4501&lng_from=30.5234&lat_to=40.7127753&lng_to=-74.0059728 The above query returns the following result:
Where 20st - 20' standard container, 40st - 40' standard container, FW - Freight wagon, TW - Tank wagon, CW - Covered wagon, HW - Hopper wagon
{
"rates": [
{
"profile": 387629,
"currency": "USD",
"rate": 402.08,
"type": "20st",
"distance": 679.696
},
{
"profile": 387629,
"currency": "USD",
"rate": 511.74,
"type": "40st",
"distance": 679.696
},
{
"profile": 472173,
"currency": "USD",
"rate": 1676.26,
"type": "FW",
"distance": 679.696
},
{
"profile": 429126,
"currency": "USD",
"rate": 1969.47,
"type": "TW",
"distance": 679.696
},
{
"profile": 251579,
"currency": "USD",
"rate": 1117.61,
"type": "CW",
"distance": 679.696
},
{
"profile": 472173,
"currency": "USD",
"rate": 1520.65,
"type": "HW",
"distance": 679.696
}
]
}
This document describes the Logistics Explorer API web service. Our API documentation allows to calculate Road rates.
| URL | https://sirius.searates.com/port/api-road?parameters |
| HTTP Method | GET |
| Output Format | JSON |
Input Parameters
| Parameter name | Required | Type | Description |
apiKey | yes | string | API key: hexadecimal number |
type | no | string | Type of shipment. The available values for this parameter are: LTL | FTL | CONTAINER
Default value: CONTAINER |
container | no | string | Container type. The available values for this parameter are: 20st | 40st | 40hq | 20ref | 40ref
Default value: 20st |
lat_from | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lng_from | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of loading. |
lat_to | yes | float number | The latitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
lng_to | yes | float number | The longitude value specifying the location for which you wish to obtain the closest sea port of discharge. |
weight | yes | integer | Weight of cargo in kg |
volume | yes | integer | Volume of cargo in CBM |
Example URL
https://sirius.searates.com/port/api-road?apiKey=XXXXXXXXXXX&lat_from=46.482526&lng_from=30.7233095&lat_to=50.4501&lng_to=30.5234&weight=0.3&volume=1&type=LTL https://sirius.searates.com/port/api-road?apiKey=XXXXXXXXXXX&lat_from=46.482526&lng_from=30.7233095&lat_to=50.4501&lng_to=30.52348&weight=0.3&volume=70&type=FTL https://sirius.searates.com/port/api-road?apiKey=XXXXXXXXXXX&lat_from=46.482526&lng_from=30.7233095&lat_to=50.4501&lng_to=30.5234&weight=0.3&volume=1&type=CONTAINER&container=40hq The above query returns the following result:
{
"rates": [
{
"m3": 60,
"rate": 440,
"currency": "USD",
"type": "FTL",
"profile_chat": 492155,
"company_name": "SeaRates LTD"
},
{
"m3": 65,
"rate": 487.5,
"currency": "USD",
"type": "FTL",
"profile_chat": 492155,
"company_name": "SeaRates LTD"
},
{
"m3": 70,
"rate": 535,
"currency": "USD",
"type": "FTL",
"profile_chat": 492155,
"company_name": "SeaRates LTD"
},
{
"m3": 75,
"rate": 582.5,
"currency": "USD",
"type": "FTL",
"profile_chat": 492155,
"company_name": "SeaRates LTD"
},
{
"m3": 80,
"rate": 630,
"currency": "USD",
"type": "FTL",
"profile_chat": 492155,
"company_name": "SeaRates LTD"
}
]
}
