Home

Introduction

Container Tracking API

version 1 [deprecated]

caution

You're viewing an older version of this API. Switch to the latest.

Container Tracking allows to determine the current position of a given container on the World Map. To track the location of the container, just specify bill of lading, container, booking number.

OpenAPI Specification

Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.

OpenAPI Spec
Postman Collection
Swagger

General information

Container Tracking API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API endpoint#

1https://sirius.searates.com/tracking

All endpoints are only accessible via HTTPS and are located at sirius.searates.com

Tracking by container

get/api

Get tracking information by container number

Headers

Content-Typeapplication/json

Query Parameters
  • api_keyREQUIREDstring

    Your api key.

    If you do not have an api key - contact us to purchase a subscription.

  • codeREQUIREDstring

    Container number

  • sealineREQUIREDnumber

    Available Sealines:

    0 - Autodetect

    1 - Mediterranean Shipping Company (MSC)

    2 - Arkas

    4 - Hamburg Sud

    5 - COSCO

    6 - Evergreen

    7 - Hapag-Lloyd

    10 - Maersk

    13 - ZIM

    14 - American President Lines (APL)

    15 - CMA CGM

    17 - Orient Overseas Container Line (OOCL)

    18 - Yang Ming

    69 - Turkon

    88 - Ocean Network Express (ONE)

    97 - Wan Hai

    104 - Hyundai Merchant Marine (HMM)

    111 - Safmarine

    112 - Sealand

    124 - Sinokor

    Allowed values:0124567101314151718698897104111112124

    Default:0

Response example
1{
2  "response": {
3    "status": "SUCCESS",
4    "points": [
5      {
6        "id": 1,
7        "name": "Xiamen",
8        "lat": 24.47979,
9        "lng": 118.08187,
10        "country": "CN",
11        "code5": "CNXMG",
12        "distTo": null,
13        "pathTo": [],
14        "events": [
15          {
16            "date": 1684934700,
17            "location": 1,
18            "description": "Gate out empty",
19            "type": 4,
20            "vessel": null,
21            "voyage": null,
22            "descr": null,
23            "planner": false
24          },
25          {
26            "date": 1684953840,
27            "location": 1,
28            "description": "Arrival in",
29            "type": 4,
30            "vessel": null,
31            "voyage": null,
32            "descr": null,
33            "planner": false
34          },
35          {
36            "date": 1685626860,
37            "location": 1,
38            "description": "Loaded",
39            "type": 4,
40            "vessel": "YM WIDTH",
41            "voyage": "029E",
42            "descr": null,
43            "planner": false
44          },
45          {
46            "date": 1685628900,
47            "location": 1,
48            "description": "Vessel departed",
49            "type": 4,
50            "vessel": "YM WIDTH",
51            "voyage": "029E",
52            "descr": null,
53            "planner": false
54          }
55        ]
56      },
57      {
58        "id": 2,
59        "name": "Savannah",
60        "lat": 32.08354,
61        "lng": -81.09983,
62        "country": "US",
63        "code5": "USSAV",
64        "distTo": 20189.667472999998,
65        "pathTo": [
66          [
67            24.47979,
68            118.08186999999998
69          ],
70          [
71            24.49113405,
72            118.16722284999997
73          ],
74          [
75            24.54407295,
76            118.56553615000001
77          ],
78          [
79            24.555417,
80            118.650889
81          ],
82          [
83            24.667171049999997,
84            119.08913065000002
85          ],
86          [
87            25.188689949999997,
88            121.13425834999998
89          ],
90          [
91            25.300444,
92            121.57249999999999
93          ],
94          [
95            22.586223249999996,
96            145.20312079999997
97          ],
98          [
99            9.919859749999999,
100            -104.5206488
101          ],
102          [
103            7.205639,
104            -80.89002800000003
105          ],
106          [
107            7.210768099999999,
108            -80.82246965000002
109          ],
110          [
111            7.2347039,
112            -80.50719735000001
113          ],
114          [
115            7.239833,
116            -80.439639
117          ],
118          [
119            7.28132885,
120            -80.37256395000003
121          ],
122          [
123            7.47497615,
124            -80.05954705000005
125          ],
126          [
127            7.516472,
128            -79.99247200000002
129          ],
130          [
131            7.73054345,
132            -79.92549055
133          ],
134          [
135            8.729543549999999,
136            -79.61291045000002
137          ],
138          [
139            8.943615,
140            -79.545929
141          ],
142          [
143            9.0070242,
144            -79.59980015000002
145          ],
146          [
147            9.3029338,
148            -79.85119885
149          ],
150          [
151            9.366343,
152            -79.90507000000002
153          ],
154          [
155            10.99826245,
156            -79.04075110000002
157          ],
158          [
159            18.61388655,
160            -75.0072629
161          ],
162          [
163            20.245806,
164            -74.142944
165          ],
166          [
167            21.998333337490987,
168            -75.16153650059721
169          ],
170          [
171            30.176794245782254,
172            -79.91496817005077
173          ],
174          [
175            31.92932158327324,
176            -80.93356067064792
177          ],
178          [
179            32.08354,
180            -81.09983
181          ]
182        ],
183        "events": [
184          {
185            "date": 1688941800,
186            "location": 2,
187            "description": "Vessel arrival",
188            "type": 4,
189            "vessel": "YM WIDTH",
190            "voyage": "029E",
191            "descr": null,
192            "planner": false
193          },
194          {
195            "date": 1689120000,
196            "location": 2,
197            "description": "Departure from",
198            "type": 4,
199            "vessel": null,
200            "voyage": null,
201            "descr": null,
202            "planner": false
203          }
204        ]
205      },
206      {
207        "id": 3,
208        "name": "Byron",
209        "lat": 32.65376,
210        "lng": -83.75963,
211        "country": "US",
212        "code5": "USBY8",
213        "distTo": 281.030933,
214        "pathTo": [
215          [
216            32.083221,
217            -81.099869
218          ],
219          [
220            32.511677,
221            -83.064117
222          ],
223          [
224            32.545055,
225            -83.159081
226          ],
227          [
228            32.574947,
229            -83.244308
230          ],
231          [
232            32.61055,
233            -83.338669
234          ],
235          [
236            32.651413,
237            -83.427612
238          ],
239          [
240            32.700237,
241            -83.507416
242          ],
243          [
244            32.775661,
245            -83.557938
246          ],
247          [
248            32.840862,
249            -83.620949
250          ],
251          [
252            32.776787,
253            -83.685692
254          ],
255          [
256            32.701237,
257            -83.735214
258          ],
259          [
260            32.65374,
261            -83.759544
262          ]
263        ],
264        "events": [
265          {
266            "date": 1689206400,
267            "location": 3,
268            "description": "Arrival in",
269            "type": 4,
270            "vessel": null,
271            "voyage": null,
272            "descr": null,
273            "planner": false
274          }
275        ]
276      }
277    ],
278    "sealine": 7,
279    "description": null,
280    "trackingID": null,
281    "containers": null,
282    "eta": 1688941800,
283    "lastContainerCord": {
284      "lat": 21.676001478100762,
285      "lng": 153.12771777158196
286    }
287  }
288}

Tracking by B/L

get/api-booking

Get tracking informanion by Bill of Lading

Headers

Content-Typeapplication/json

Query Parameters
  • api_keyREQUIREDstring

    Your api key.

    If you do not have an api key - contact us to purchase a subscription.

  • numberREQUIREDstring

    Bill of Lading number as sealine format

  • sealineREQUIREDnumber

    Available Sealines:

    0 - Autodetect

    1 - Mediterranean Shipping Company (MSC)

    2 - Arkas

    4 - Hamburg Sud

    5 - COSCO

    6 - Evergreen

    7 - Hapag-Lloyd

    10 - Maersk

    13 - ZIM

    14 - American President Lines (APL)

    15 - CMA CGM

    17 - Orient Overseas Container Line (OOCL)

    18 - Yang Ming

    69 - Turkon

    88 - Ocean Network Express (ONE)

    97 - Wan Hai

    104 - Hyundai Merchant Marine (HMM)

    111 - Safmarine

    112 - Sealand

    124 - Sinokor

    Allowed values:0124567101314151718698897104111112124

    Default:0

  • typeOptionalstring

    Type of shipment number:

    BL - Bill of lading number

    BK - Booking number

    Allowed values:BLBK

    Default:BL

  • define_pathOptionalboolean

    Set true to get route information

    Default:false

Response example
1{
2  "status": "SUCCESS",
3  "result": {
4    "bl_number": "HLCUXM1230445340",
5    "origin": "Xiamen, China",
6    "origin_code5": "CNXMG",
7    "pol": "Xiamen, China",
8    "pol_code5": "CNXMG",
9    "pod": "Savannah, United States",
10    "pod_code5": "USSAV",
11    "destination": null,
12    "destination_code5": null,
13    "etd": "24.05.2023 18:44",
14    "eta": "13.07.2023 16:30"
15  },
16  "containers": [
17    {
18      "number": "UACU5367911",
19      "type": "45G1",
20      "events": [
21        {
22          "no": 1,
23          "date": "25.05.2023 11:57",
24          "status": "Gate out empty",
25          "description": "Container empty to shipper",
26          "location": "Xiamen, China",
27          "name": "Xiamen",
28          "county": "CN",
29          "latitude": 24.47979,
30          "longitude": 118.08187,
31          "code5": "CNXMG",
32          "voyage": null,
33          "vessel": null,
34          "imo": null,
35          "mmsi": null,
36          "call_sign": null,
37          "flag": null
38        },
39        {
40          "no": 2,
41          "date": "25.05.2023 23:15",
42          "status": "Arrival in",
43          "description": "Container arrival at first POL (Gate in)",
44          "location": "Xiamen, China",
45          "name": "Xiamen",
46          "county": "CN",
47          "latitude": 24.47979,
48          "longitude": 118.08187,
49          "code5": "CNXMG",
50          "voyage": null,
51          "vessel": null,
52          "imo": null,
53          "mmsi": null,
54          "call_sign": null,
55          "flag": null
56        },
57        {
58          "no": 3,
59          "date": "01.06.2023 10:03",
60          "status": "Loaded",
61          "description": "Container loaded at first POL",
62          "location": "Xiamen, China",
63          "name": "Xiamen",
64          "county": "CN",
65          "latitude": 24.47979,
66          "longitude": 118.08187,
67          "code5": "CNXMG",
68          "voyage": "029E",
69          "vessel": "YM WIDTH",
70          "imo": 9708447,
71          "mmsi": 477129300,
72          "call_sign": "VRPE5",
73          "flag": "HK"
74        },
75        {
76          "no": 4,
77          "date": "01.06.2023 14:15",
78          "status": "Vessel departed",
79          "description": "Vessel departure from first POL",
80          "location": "Xiamen, China",
81          "name": "Xiamen",
82          "county": "CN",
83          "latitude": 24.47979,
84          "longitude": 118.08187,
85          "code5": "CNXMG",
86          "voyage": "029E",
87          "vessel": "YM WIDTH",
88          "imo": 9708447,
89          "mmsi": 477129300,
90          "call_sign": "VRPE5",
91          "flag": "HK"
92        },
93        {
94          "no": 5,
95          "date": "13.07.2023 16:30",
96          "status": "Vessel arrival",
97          "description": "Vessel arrival at final POD",
98          "location": "Savannah, United States",
99          "name": "Savannah",
100          "county": "US",
101          "latitude": 32.08354,
102          "longitude": -81.09983,
103          "code5": "USSAV",
104          "voyage": "029E",
105          "vessel": "YM WIDTH",
106          "imo": 9708447,
107          "mmsi": 477129300,
108          "call_sign": "VRPE5",
109          "flag": "HK"
110        },
111        {
112          "no": 6,
113          "date": "13.07.2023 16:30",
114          "status": "Departure from",
115          "description": "Land transshipment",
116          "location": "Savannah, United States",
117          "name": "Savannah",
118          "county": "US",
119          "latitude": 32.08354,
120          "longitude": -81.09983,
121          "code5": "USSAV",
122          "voyage": null,
123          "vessel": null,
124          "imo": null,
125          "mmsi": null,
126          "call_sign": null,
127          "flag": null
128        },
129        {
130          "no": 7,
131          "date": "14.07.2023 00:00",
132          "status": "Arrival in",
133          "description": "Land transshipment",
134          "location": "Byron, United States",
135          "name": "Byron",
136          "county": "US",
137          "latitude": 32.65376,
138          "longitude": -83.75963,
139          "code5": "USBY8",
140          "voyage": null,
141          "vessel": null,
142          "imo": null,
143          "mmsi": null,
144          "call_sign": null,
145          "flag": null
146        }
147      ]
148    },
149    {
150      "number": "UACU5710126",
151      "type": "45G1",
152      "events": [
153        {
154          "no": 1,
155          "date": "24.05.2023 13:25",
156          "status": "Gate out empty",
157          "description": "Container empty to shipper",
158          "location": "Xiamen, China",
159          "name": "Xiamen",
160          "county": "CN",
161          "latitude": 24.47979,
162          "longitude": 118.08187,
163          "code5": "CNXMG",
164          "voyage": null,
165          "vessel": null,
166          "imo": null,
167          "mmsi": null,
168          "call_sign": null,
169          "flag": null
170        },
171        {
172          "no": 2,
173          "date": "24.05.2023 18:44",
174          "status": "Arrival in",
175          "description": "Container arrival at first POL (Gate in)",
176          "location": "Xiamen, China",
177          "name": "Xiamen",
178          "county": "CN",
179          "latitude": 24.47979,
180          "longitude": 118.08187,
181          "code5": "CNXMG",
182          "voyage": null,
183          "vessel": null,
184          "imo": null,
185          "mmsi": null,
186          "call_sign": null,
187          "flag": null
188        },
189        {
190          "no": 3,
191          "date": "01.06.2023 13:41",
192          "status": "Loaded",
193          "description": "Container loaded at first POL",
194          "location": "Xiamen, China",
195          "name": "Xiamen",
196          "county": "CN",
197          "latitude": 24.47979,
198          "longitude": 118.08187,
199          "code5": "CNXMG",
200          "voyage": "029E",
201          "vessel": "YM WIDTH",
202          "imo": 9708447,
203          "mmsi": 477129300,
204          "call_sign": "VRPE5",
205          "flag": "HK"
206        },
207        {
208          "no": 4,
209          "date": "01.06.2023 14:15",
210          "status": "Vessel departed",
211          "description": "Vessel departure from first POL",
212          "location": "Xiamen, China",
213          "name": "Xiamen",
214          "county": "CN",
215          "latitude": 24.47979,
216          "longitude": 118.08187,
217          "code5": "CNXMG",
218          "voyage": "029E",
219          "vessel": "YM WIDTH",
220          "imo": 9708447,
221          "mmsi": 477129300,
222          "call_sign": "VRPE5",
223          "flag": "HK"
224        },
225        {
226          "no": 5,
227          "date": "13.07.2023 16:30",
228          "status": "Vessel arrival",
229          "description": "Vessel arrival at final POD",
230          "location": "Savannah, United States",
231          "name": "Savannah",
232          "county": "US",
233          "latitude": 32.08354,
234          "longitude": -81.09983,
235          "code5": "USSAV",
236          "voyage": "029E",
237          "vessel": "YM WIDTH",
238          "imo": 9708447,
239          "mmsi": 477129300,
240          "call_sign": "VRPE5",
241          "flag": "HK"
242        },
243        {
244          "no": 6,
245          "date": "13.07.2023 16:30",
246          "status": "Departure from",
247          "description": "Land transshipment",
248          "location": "Savannah, United States",
249          "name": "Savannah",
250          "county": "US",
251          "latitude": 32.08354,
252          "longitude": -81.09983,
253          "code5": "USSAV",
254          "voyage": null,
255          "vessel": null,
256          "imo": null,
257          "mmsi": null,
258          "call_sign": null,
259          "flag": null
260        },
261        {
262          "no": 7,
263          "date": "14.07.2023 00:00",
264          "status": "Arrival in",
265          "description": "Land transshipment",
266          "location": "Byron, United States",
267          "name": "Byron",
268          "county": "US",
269          "latitude": 32.65376,
270          "longitude": -83.75963,
271          "code5": "USBY8",
272          "voyage": null,
273          "vessel": null,
274          "imo": null,
275          "mmsi": null,
276          "call_sign": null,
277          "flag": null
278        }
279      ]
280    }
281  ],
282  "route": [],
283  "ais": {
284    "vessel": "YM WIDTH",
285    "ais_time": null,
286    "lat": null,
287    "lng": null
288  }
289}
SeaRates 2023—Find a toolRequest an IT quoteContact us