Introduction

Container Tracking API

version 2 [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://tracking.searates.com

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

Tracking by container

[ deprecated ]

get/apiv2

Get tracking information by container number. This operation has been marked as deprecated. Use GET /tracking

An API key is a token that you provide when making API calls. Include the token in a query parameter called api_key

Example: ?api_key=123

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