Home

Calculate

post/container/demurrage-calculate/

Calculate

Headers

Content-Typeapplication/json

Body Parameters
  • dischargeDateOptionalstring

    Date when a container was discharget at the port of destination

    Example:2024-11-1

  • dateOutFullOptionalstring

    Loaded container with import cargo left th port of discharge for on-carriage to the final destination

    Example:2024-11-7

  • dateInEmptyOptionalstring

    Empty container returned to the terminal passed back to the Carrier

    Example:2024-11-30

  • storageOptionalarray[object]

    Terminal storage is a fee that a Carrier or a Terminal itself charges cargo owner, their forwarder or agent. It counts for all days loaded container is placed on the yard; unfull day counts as full.

  • demurrageOptionalarray[object]

    Demurrage is a fee imposed by Carriers for excessive use of container or transport. It starts from the moment container is unloaded from ship (import) or picked up for loading (export). Some free days are normally given to return container back to Carrier's yard. Every day exceeding that timeframe is charged as a penalty, and most often - at progressive scale.

  • detentionOptionalarray[object]

    Detention is a general transport penalty, similar to demurrage. Applied to containers it normally counts when the unit is outside of the terminal and usage exceeds free days.

Response example
OK
1{
2  "code": 200,
3  "data": {
4    "storage": {
5      "currency": "USD",
6      "total": 20
7    },
8    "demurrage": {
9      "currency": "USD",
10      "total": 670
11    },
12    "detention": {
13      "currency": "USD",
14      "total": 490
15    },
16    "total": {
17      "currency": "USD",
18      "value": 1180
19    }
20  }
21}

Container list

get/container/get-container-list

Returns a list of containers

Headers

Content-Typeapplication/json

Response example
OK
1{
2  "code": 200,
3  "data": [
4    {
5      "id": 1,
6      "name": "20' Standard",
7      "short_name": "20' ST"
8    },
9    {
10      "id": 2,
11      "name": "40' Standard",
12      "short_name": "40' ST"
13    },
14    {
15      "id": 3,
16      "name": "40' High Cube",
17      "short_name": "40' HC"
18    },
19    {
20      "id": 50,
21      "name": "45' High Cube",
22      "short_name": "45' HC"
23    },
24    {
25      "id": 4,
26      "name": "20' Refrigerated",
27      "short_name": "20' REF"
28    },
29    {
30      "id": 5,
31      "name": "40' Refrigerated",
32      "short_name": "40' REF"
33    },
34    {
35      "id": 6,
36      "name": "20' Open Top",
37      "short_name": "20' OT"
38    },
39    {
40      "id": 7,
41      "name": "40' Open Top",
42      "short_name": "40' OT"
43    },
44    {
45      "id": 8,
46      "name": "20' Flatrack",
47      "short_name": "20' FL"
48    },
49    {
50      "id": 9,
51      "name": "40' Flatrack",
52      "short_name": "40' FL"
53    },
54    {
55      "id": 46,
56      "name": "20' Flatrack Collapsible",
57      "short_name": "20' FLC"
58    },
59    {
60      "id": 45,
61      "name": "40' Flatrack Collapsible",
62      "short_name": "40' FLC"
63    },
64    {
65      "id": 112,
66      "name": "20' High Cube",
67      "short_name": "20' HC"
68    },
69    {
70      "id": 113,
71      "name": "20' Pallet Wide",
72      "short_name": "20' PW"
73    },
74    {
75      "id": 111,
76      "name": "20' High Cube Pallet Wide",
77      "short_name": "20' HCPW"
78    },
79    {
80      "id": 115,
81      "name": "40' Pallet Wide",
82      "short_name": "40' PW"
83    },
84    {
85      "id": 114,
86      "name": "40' High Cube Pallet Wide",
87      "short_name": "40' HCPW"
88    },
89    {
90      "id": 116,
91      "name": "45' High Cube Pallet Wide",
92      "short_name": "45' HCPW"
93    },
94    {
95      "id": 106,
96      "name": "10' Standard",
97      "short_name": "10' ST"
98    },
99    {
100      "id": 49,
101      "name": "20' Bulk",
102      "short_name": "20' BK"
103    },
104    {
105      "id": 12,
106      "name": "20' Tank",
107      "short_name": "20' TG"
108    },
109    {
110      "id": 47,
111      "name": "20' Platform",
112      "short_name": "20' PL"
113    },
114    {
115      "id": 48,
116      "name": "40' Platform",
117      "short_name": "40' PL"
118    },
119    {
120      "id": 117,
121      "name": "48' High Cube",
122      "short_name": "48' HC"
123    },
124    {
125      "id": 118,
126      "name": "53' High Cube",
127      "short_name": "53' HC"
128    }
129  ]
130}

Shipping lines list

post/container/get-shipping-lines-list

Returns a list of lines for which tariffs are available

Headers

Content-Typeapplication/json

Body Parameters
  • portIdOptionalinteger

    Port id received via autocomplete

    Example:706

Response example
OK
1{
2  "code": 200,
3  "data": [
4    {
5      "id": 5,
6      "name": "COSCO",
7      "scac": "COSU"
8    },
9    {
10      "id": 7,
11      "name": "Hapag-Lloyd",
12      "scac": "HLCU"
13    },
14    {
15      "id": 15,
16      "name": "CMA CGM",
17      "scac": "CMDU"
18    }
19  ]
20}

Get Tariffs

post/container/get-demurrage-data
Headers

Content-Typeapplication/json

Body Parameters
  • portIdOptionalinteger

    Port id received via autocomplete

  • typeOptionalno type

    Type, import or export

    Allowed values:importexport

    Default:import

    Example:import

  • containerIdOptionalinteger

    Container id received via Container list

    Example:1

  • shippingLineIdOptionalinteger

    Shipping line id received via Shipping lines list

    Example:5

Request sample
{
  "portId": 11978,
  "type": "import",
  "containerId": 1,
  "shippingLineId": 15
}
Response example
OK
1{
2  "code": 200,
3  "data": {
4    "storage": null,
5    "demurrage": [
6      {
7        "sinceDay": 1,
8        "untilDay": 10,
9        "rate": 0,
10        "currency": "EUR"
11      },
12      {
13        "sinceDay": 11,
14        "untilDay": 17,
15        "rate": 20,
16        "currency": "EUR"
17      },
18      {
19        "sinceDay": 18,
20        "untilDay": 99,
21        "rate": 40,
22        "currency": "EUR"
23      }
24    ],
25    "detention": [
26      {
27        "sinceDay": 1,
28        "untilDay": 10,
29        "rate": 0,
30        "currency": "EUR"
31      },
32      {
33        "sinceDay": 11,
34        "untilDay": 17,
35        "rate": 20,
36        "currency": "EUR"
37      },
38      {
39        "sinceDay": 18,
40        "untilDay": 99,
41        "rate": 40,
42        "currency": "EUR"
43      }
44    ]
45  }
46}