Home

Introduction

Ship Schedules API

version 2

Ship Schedules API allows you to get instant sailing itineraries for vessels of multiple shipping lines together with full associated details.

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.

General information

Ship Schedules 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://schedules.searates.com/api/v2

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

Schedules by Points

get/schedules/by-points

Get schedules for particular direction using UN/LOCODEs for ports, and SCACs for carriers filter.

Headers

Content-Typeapplication/json

Query Parameters
  • carriersOptionalstring

    SCAC codes list

    Example:MSCU,MAEU,COSU,EGLV,YMLU,HDMU

    Match pattern:^([A-Z0-9]{4}(?:(,[A-Z0-9]{4})){0,})$

  • cargo_typeREQUIREDstring

    Filter schedules by cargo type:

    GC - General cargo

    REEF - Reefer

    RORO - Ro-Ro cargo

    LCL - Less container load

    Allowed values:GCREEFLCLRORO

  • originREQUIREDstring

    Origin port UN/LOCODE

    Example:AEJEA

    Match pattern:^[A-Z0-9]{5}$

  • destinationREQUIREDstring

    Destination port UN/LOCODE

    Example:CNSHA

    Match pattern:^[A-Z0-9]{5}$

  • from_dateREQUIREDstring

    Start from date - specify the date in format yyyy-mm-dd. Must be current date or future date

    Example:2024-04-02

    Match pattern:^(\d{4}-\d{2}-\d{2})$

  • weeksREQUIREDinteger

    Weeks ahead to display

    >= 1<= 6

    Example:3

  • sortREQUIREDstring

    Sorting schedules mode:

    DEP - Sort schedules by departure date

    ARR - Sort schedules by arrival date

    TT - Sort schedules by transit time

    Allowed values:DEPARRTT

  • direct_onlyOptionalboolean

    Show only direct service

    Default:false

  • multimodalOptionalboolean

    Show multimodal schedules

    Default:true

Response example
Schedules by Points
1{
2  "success": true,
3  "status_code": "OK",
4  "metadata": {
5    "request_parameters": {
6      "carriers": "MAEU,MSCU,COSU",
7      "cargo_type": "GC",
8      "origin": "ITGOA",
9      "destination": "EGALY",
10      "from_date": "2024-05-02",
11      "sort": "DEP",
12      "weeks": 6,
13      "direct_only": false,
14      "multimodal": true
15    },
16    "response_stats": [
17      {
18        "status_code": "SCHEDULES_FOUND",
19        "carrier_name": "MSC",
20        "found_schedules": 7
21      },
22      {
23        "status_code": "SCHEDULES_NOT_FOUND",
24        "carrier_name": "MAERSK",
25        "found_schedules": 0
26      },
27      {
28        "status_code": "SCHEDULES_FOUND",
29        "carrier_name": "COSCO",
30        "found_schedules": 4
31      }
32    ]
33  },
34  "data": {
35    "schedules": [
36      {
37        "schedule_id": 3640,
38        "carrier_name": "COSCO",
39        "carrier_scac": "COSU",
40        "cargo_type": "GC",
41        "origin": {
42          "estimated_date": "2024-05-05 01:46:00",
43          "port_name": "Genoa",
44          "port_locode": "ITGOA",
45          "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
46          "terminal_code": null
47        },
48        "destination": {
49          "estimated_date": "2024-05-17 03:00:00",
50          "port_name": "Alexandria",
51          "port_locode": "EGALY",
52          "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
53          "terminal_code": null
54        },
55        "legs": [
56          {
57            "order_id": 1,
58            "mode": "VESSEL",
59            "vessel_name": "TAMPA TRIUMPH",
60            "vessel_imo": null,
61            "voyages": [
62              {
63                "name": "voyage",
64                "voyage": "0638-035E"
65              }
66            ],
67            "departure": {
68              "estimated_date": "2024-05-05 01:46:00",
69              "port_name": "Genoa",
70              "port_locode": "ITGOA",
71              "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
72              "terminal_code": null
73            },
74            "arrival": {
75              "estimated_date": "2024-05-13 07:00:00",
76              "port_name": "Piraeus",
77              "port_locode": "GRPIR",
78              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
79              "terminal_code": null
80            },
81            "service_name": "AEM1",
82            "service_code": null
83          },
84          {
85            "order_id": 2,
86            "mode": "VESSEL",
87            "vessel_name": "MONTPELLIER",
88            "vessel_imo": null,
89            "voyages": [
90              {
91                "name": "voyage",
92                "voyage": "073E"
93              }
94            ],
95            "departure": {
96              "estimated_date": "2024-05-15 11:00:00",
97              "port_name": "Piraeus",
98              "port_locode": "GRPIR",
99              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
100              "terminal_code": null
101            },
102            "arrival": {
103              "estimated_date": "2024-05-17 03:00:00",
104              "port_name": "Alexandria",
105              "port_locode": "EGALY",
106              "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
107              "terminal_code": null
108            },
109            "service_name": "AGX",
110            "service_code": null
111          }
112        ],
113        "cut_off_dates": [],
114        "transit_time": 12,
115        "direct": false,
116        "updated_at": "2024-05-10 12:35:51"
117      },
118      {
119        "schedule_id": 3088,
120        "carrier_name": "COSCO",
121        "carrier_scac": "COSU",
122        "cargo_type": "GC",
123        "origin": {
124          "estimated_date": "2024-05-08 14:52:00",
125          "port_name": "Genoa",
126          "port_locode": "ITGOA",
127          "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
128          "terminal_code": null
129        },
130        "destination": {
131          "estimated_date": "2024-08-24 23:00:00",
132          "port_name": "Alexandria",
133          "port_locode": "EGALY",
134          "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
135          "terminal_code": null
136        },
137        "legs": [
138          {
139            "order_id": 1,
140            "mode": "VESSEL",
141            "vessel_name": "COSCO SHIPPING NEBULA",
142            "vessel_imo": null,
143            "voyages": [
144              {
145                "name": "voyage",
146                "voyage": "025E"
147              }
148            ],
149            "departure": {
150              "estimated_date": "2024-05-08 14:52:00",
151              "port_name": "Genoa",
152              "port_locode": "ITGOA",
153              "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
154              "terminal_code": null
155            },
156            "arrival": {
157              "estimated_date": "2024-08-15 07:00:00",
158              "port_name": "Piraeus",
159              "port_locode": "GRPIR",
160              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
161              "terminal_code": null
162            },
163            "service_name": "AEM1",
164            "service_code": null
165          },
166          {
167            "order_id": 2,
168            "mode": "VESSEL",
169            "vessel_name": "VEGA COLIGNY",
170            "vessel_imo": null,
171            "voyages": [
172              {
173                "name": "voyage",
174                "voyage": "027E"
175              }
176            ],
177            "departure": {
178              "estimated_date": "2024-08-21 10:00:00",
179              "port_name": "Piraeus",
180              "port_locode": "GRPIR",
181              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
182              "terminal_code": null
183            },
184            "arrival": {
185              "estimated_date": "2024-08-24 23:00:00",
186              "port_name": "Alexandria",
187              "port_locode": "EGALY",
188              "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
189              "terminal_code": null
190            },
191            "service_name": "AGX",
192            "service_code": null
193          }
194        ],
195        "cut_off_dates": [],
196        "transit_time": 108,
197        "direct": false,
198        "updated_at": "2024-05-10 12:35:51"
199      },
200      {
201        "schedule_id": 2743,
202        "carrier_name": "MSC",
203        "carrier_scac": "MSCU",
204        "cargo_type": "GC",
205        "origin": {
206          "estimated_date": "2024-05-08 18:48:00",
207          "port_name": "GENOA",
208          "port_locode": "ITGOA",
209          "terminal_name": "BETTOLO CONTAINER TERMINAL",
210          "terminal_code": null
211        },
212        "destination": {
213          "estimated_date": "2024-05-24 22:15:00",
214          "port_name": "ALEXANDRIA OLD PORT",
215          "port_locode": "EGALY",
216          "terminal_name": "ALEXANDRIA OLD PORT",
217          "terminal_code": null
218        },
219        "legs": [
220          {
221            "order_id": 1,
222            "mode": "VESSEL",
223            "vessel_name": "MSC ALIX 3",
224            "vessel_imo": 9166651,
225            "voyages": [
226              {
227                "name": "voyage",
228                "voyage": "AC418A"
229              }
230            ],
231            "departure": {
232              "estimated_date": "2024-05-08 18:48:00",
233              "port_name": "GENOA",
234              "port_locode": "ITGOA",
235              "terminal_name": "BETTOLO CONTAINER TERMINAL",
236              "terminal_code": null
237            },
238            "arrival": {
239              "estimated_date": "2024-05-10 12:33:00",
240              "port_name": "GIOIA TAURO",
241              "port_locode": "ITGIT",
242              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
243              "terminal_code": null
244            },
245            "service_name": "LINE B",
246            "service_code": null
247          },
248          {
249            "order_id": 2,
250            "mode": "VESSEL",
251            "vessel_name": "MSC HARMONY III",
252            "vessel_imo": 9309411,
253            "voyages": [
254              {
255                "name": "voyage",
256                "voyage": "AB418A"
257              }
258            ],
259            "departure": {
260              "estimated_date": "2024-05-17 07:00:00",
261              "port_name": "GIOIA TAURO",
262              "port_locode": "ITGIT",
263              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
264              "terminal_code": null
265            },
266            "arrival": {
267              "estimated_date": "2024-05-24 22:15:00",
268              "port_name": "ALEXANDRIA OLD PORT",
269              "port_locode": "EGALY",
270              "terminal_name": "ALEXANDRIA OLD PORT",
271              "terminal_code": null
272            },
273            "service_name": "ADRIATIC TO E - MED",
274            "service_code": null
275          }
276        ],
277        "cut_off_dates": [],
278        "transit_time": 16,
279        "direct": false,
280        "updated_at": "2024-05-10 12:35:51"
281      },
282      {
283        "schedule_id": 2437,
284        "carrier_name": "COSCO",
285        "carrier_scac": "COSU",
286        "cargo_type": "GC",
287        "origin": {
288          "estimated_date": "2024-05-10 11:24:00",
289          "port_name": "Genoa",
290          "port_locode": "ITGOA",
291          "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
292          "terminal_code": null
293        },
294        "destination": {
295          "estimated_date": "2024-05-24 03:00:00",
296          "port_name": "Alexandria",
297          "port_locode": "EGALY",
298          "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
299          "terminal_code": null
300        },
301        "legs": [
302          {
303            "order_id": 1,
304            "mode": "VESSEL",
305            "vessel_name": "THALASSA TYHI",
306            "vessel_imo": null,
307            "voyages": [
308              {
309                "name": "voyage",
310                "voyage": "0639-047E"
311              }
312            ],
313            "departure": {
314              "estimated_date": "2024-05-10 11:24:00",
315              "port_name": "Genoa",
316              "port_locode": "ITGOA",
317              "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
318              "terminal_code": null
319            },
320            "arrival": {
321              "estimated_date": "2024-05-17 07:00:00",
322              "port_name": "Piraeus",
323              "port_locode": "GRPIR",
324              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
325              "terminal_code": null
326            },
327            "service_name": "AEM1",
328            "service_code": null
329          },
330          {
331            "order_id": 2,
332            "mode": "VESSEL",
333            "vessel_name": "CMA CGM MONTREAL",
334            "vessel_imo": null,
335            "voyages": [
336              {
337                "name": "voyage",
338                "voyage": "0DMGTS1NL"
339              }
340            ],
341            "departure": {
342              "estimated_date": "2024-05-22 10:00:00",
343              "port_name": "Piraeus",
344              "port_locode": "GRPIR",
345              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
346              "terminal_code": null
347            },
348            "arrival": {
349              "estimated_date": "2024-05-24 03:00:00",
350              "port_name": "Alexandria",
351              "port_locode": "EGALY",
352              "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
353              "terminal_code": null
354            },
355            "service_name": "AGX",
356            "service_code": null
357          }
358        ],
359        "cut_off_dates": [],
360        "transit_time": 14,
361        "direct": false,
362        "updated_at": "2024-05-10 12:35:51"
363      },
364      {
365        "schedule_id": 3445,
366        "carrier_name": "MSC",
367        "carrier_scac": "MSCU",
368        "cargo_type": "GC",
369        "origin": {
370          "estimated_date": "2024-05-18 23:00:00",
371          "port_name": "GENOA",
372          "port_locode": "ITGOA",
373          "terminal_name": "BETTOLO CONTAINER TERMINAL",
374          "terminal_code": null
375        },
376        "destination": {
377          "estimated_date": "2024-05-30 21:35:00",
378          "port_name": "ALEXANDRIA OLD PORT",
379          "port_locode": "EGALY",
380          "terminal_name": "ALEXANDRIA OLD PORT",
381          "terminal_code": null
382        },
383        "legs": [
384          {
385            "order_id": 1,
386            "mode": "VESSEL",
387            "vessel_name": "MSC MASHA 3",
388            "vessel_imo": 9188219,
389            "voyages": [
390              {
391                "name": "voyage",
392                "voyage": "AC420A"
393              }
394            ],
395            "departure": {
396              "estimated_date": "2024-05-18 23:00:00",
397              "port_name": "GENOA",
398              "port_locode": "ITGOA",
399              "terminal_name": "BETTOLO CONTAINER TERMINAL",
400              "terminal_code": null
401            },
402            "arrival": {
403              "estimated_date": "2024-05-20 16:45:00",
404              "port_name": "GIOIA TAURO",
405              "port_locode": "ITGIT",
406              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
407              "terminal_code": null
408            },
409            "service_name": "LINE B",
410            "service_code": null
411          },
412          {
413            "order_id": 2,
414            "mode": "VESSEL",
415            "vessel_name": "MSC HANNAH",
416            "vessel_imo": 9316347,
417            "voyages": [
418              {
419                "name": "voyage",
420                "voyage": "AB419A"
421              }
422            ],
423            "departure": {
424              "estimated_date": "2024-05-23 06:20:00",
425              "port_name": "GIOIA TAURO",
426              "port_locode": "ITGIT",
427              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
428              "terminal_code": null
429            },
430            "arrival": {
431              "estimated_date": "2024-05-30 21:35:00",
432              "port_name": "ALEXANDRIA OLD PORT",
433              "port_locode": "EGALY",
434              "terminal_name": "ALEXANDRIA OLD PORT",
435              "terminal_code": null
436            },
437            "service_name": "ADRIATIC TO E - MED",
438            "service_code": null
439          }
440        ],
441        "cut_off_dates": [],
442        "transit_time": 12,
443        "direct": false,
444        "updated_at": "2024-05-10 12:35:51"
445      },
446      {
447        "schedule_id": 3368,
448        "carrier_name": "MSC",
449        "carrier_scac": "MSCU",
450        "cargo_type": "GC",
451        "origin": {
452          "estimated_date": "2024-05-27 13:18:00",
453          "port_name": "GENOA",
454          "port_locode": "ITGOA",
455          "terminal_name": "BETTOLO CONTAINER TERMINAL",
456          "terminal_code": null
457        },
458        "destination": {
459          "estimated_date": "2024-06-07 13:03:00",
460          "port_name": "ALEXANDRIA OLD PORT",
461          "port_locode": "EGALY",
462          "terminal_name": "ALEXANDRIA OLD PORT",
463          "terminal_code": null
464        },
465        "legs": [
466          {
467            "order_id": 1,
468            "mode": "VESSEL",
469            "vessel_name": "MSC RHIANNON",
470            "vessel_imo": 9224051,
471            "voyages": [
472              {
473                "name": "voyage",
474                "voyage": "AC421A"
475              }
476            ],
477            "departure": {
478              "estimated_date": "2024-05-27 13:18:00",
479              "port_name": "GENOA",
480              "port_locode": "ITGOA",
481              "terminal_name": "BETTOLO CONTAINER TERMINAL",
482              "terminal_code": null
483            },
484            "arrival": {
485              "estimated_date": "2024-05-29 07:03:00",
486              "port_name": "GIOIA TAURO",
487              "port_locode": "ITGIT",
488              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
489              "terminal_code": null
490            },
491            "service_name": "LINE B",
492            "service_code": null
493          },
494          {
495            "order_id": 2,
496            "mode": "VESSEL",
497            "vessel_name": "TBN",
498            "vessel_imo": null,
499            "voyages": [
500              {
501                "name": "voyage",
502                "voyage": "TBN"
503              }
504            ],
505            "departure": {
506              "estimated_date": "2024-05-30 22:03:00",
507              "port_name": "GIOIA TAURO",
508              "port_locode": "ITGIT",
509              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
510              "terminal_code": null
511            },
512            "arrival": {
513              "estimated_date": "2024-06-07 13:03:00",
514              "port_name": "ALEXANDRIA OLD PORT",
515              "port_locode": "EGALY",
516              "terminal_name": "ALEXANDRIA OLD PORT",
517              "terminal_code": null
518            },
519            "service_name": "ADRIATIC TO E - MED",
520            "service_code": null
521          }
522        ],
523        "cut_off_dates": [],
524        "transit_time": 11,
525        "direct": false,
526        "updated_at": "2024-05-10 12:35:51"
527      },
528      {
529        "schedule_id": 3849,
530        "carrier_name": "COSCO",
531        "carrier_scac": "COSU",
532        "cargo_type": "GC",
533        "origin": {
534          "estimated_date": "2024-06-01 18:00:00",
535          "port_name": "Genoa",
536          "port_locode": "ITGOA",
537          "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
538          "terminal_code": null
539        },
540        "destination": {
541          "estimated_date": "2024-09-06 03:00:00",
542          "port_name": "Alexandria",
543          "port_locode": "EGALY",
544          "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
545          "terminal_code": null
546        },
547        "legs": [
548          {
549            "order_id": 1,
550            "mode": "VESSEL",
551            "vessel_name": "COSCO SHIPPING PISCES",
552            "vessel_imo": null,
553            "voyages": [
554              {
555                "name": "voyage",
556                "voyage": "025E"
557              }
558            ],
559            "departure": {
560              "estimated_date": "2024-06-01 18:00:00",
561              "port_name": "Genoa",
562              "port_locode": "ITGOA",
563              "terminal_name": "Voltri Terminal Europa SpA Porto di Voltri 16158 Genoa Italy",
564              "terminal_code": null
565            },
566            "arrival": {
567              "estimated_date": "2024-08-29 07:00:00",
568              "port_name": "Piraeus",
569              "port_locode": "GRPIR",
570              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
571              "terminal_code": null
572            },
573            "service_name": "AEM1",
574            "service_code": null
575          },
576          {
577            "order_id": 2,
578            "mode": "VESSEL",
579            "vessel_name": "MONTPELLIER",
580            "vessel_imo": null,
581            "voyages": [
582              {
583                "name": "voyage",
584                "voyage": "077E"
585              }
586            ],
587            "departure": {
588              "estimated_date": "2024-09-04 10:00:00",
589              "port_name": "Piraeus",
590              "port_locode": "GRPIR",
591              "terminal_name": "Piraeus Container Terminal Piraeus Container Terminal N. Sempo, N. Ikonio, 18863 Perama Greece",
592              "terminal_code": null
593            },
594            "arrival": {
595              "estimated_date": "2024-09-06 03:00:00",
596              "port_name": "Alexandria",
597              "port_locode": "EGALY",
598              "terminal_name": "El-Dekheala Container Terminal El-Dekheala Container Terminal (Dkchc)",
599              "terminal_code": null
600            },
601            "service_name": "AGX",
602            "service_code": null
603          }
604        ],
605        "cut_off_dates": [],
606        "transit_time": 97,
607        "direct": false,
608        "updated_at": "2024-05-10 12:35:51"
609      },
610      {
611        "schedule_id": 3189,
612        "carrier_name": "MSC",
613        "carrier_scac": "MSCU",
614        "cargo_type": "GC",
615        "origin": {
616          "estimated_date": "2024-06-05 18:48:00",
617          "port_name": "GENOA",
618          "port_locode": "ITGOA",
619          "terminal_name": "BETTOLO CONTAINER TERMINAL",
620          "terminal_code": null
621        },
622        "destination": {
623          "estimated_date": "2024-06-16 18:33:00",
624          "port_name": "ALEXANDRIA OLD PORT",
625          "port_locode": "EGALY",
626          "terminal_name": "ALEXANDRIA OLD PORT",
627          "terminal_code": null
628        },
629        "legs": [
630          {
631            "order_id": 1,
632            "mode": "VESSEL",
633            "vessel_name": "MSC ALIX 3",
634            "vessel_imo": 9166651,
635            "voyages": [
636              {
637                "name": "voyage",
638                "voyage": "AC422A"
639              }
640            ],
641            "departure": {
642              "estimated_date": "2024-06-05 18:48:00",
643              "port_name": "GENOA",
644              "port_locode": "ITGOA",
645              "terminal_name": "BETTOLO CONTAINER TERMINAL",
646              "terminal_code": null
647            },
648            "arrival": {
649              "estimated_date": "2024-06-07 12:33:00",
650              "port_name": "GIOIA TAURO",
651              "port_locode": "ITGIT",
652              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
653              "terminal_code": null
654            },
655            "service_name": "LINE B",
656            "service_code": null
657          },
658          {
659            "order_id": 2,
660            "mode": "VESSEL",
661            "vessel_name": "TBN",
662            "vessel_imo": null,
663            "voyages": [
664              {
665                "name": "voyage",
666                "voyage": "TBN"
667              }
668            ],
669            "departure": {
670              "estimated_date": "2024-06-09 03:33:00",
671              "port_name": "GIOIA TAURO",
672              "port_locode": "ITGIT",
673              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
674              "terminal_code": null
675            },
676            "arrival": {
677              "estimated_date": "2024-06-16 18:33:00",
678              "port_name": "ALEXANDRIA OLD PORT",
679              "port_locode": "EGALY",
680              "terminal_name": "ALEXANDRIA OLD PORT",
681              "terminal_code": null
682            },
683            "service_name": "ADRIATIC TO E - MED",
684            "service_code": null
685          }
686        ],
687        "cut_off_dates": [],
688        "transit_time": 11,
689        "direct": false,
690        "updated_at": "2024-05-10 12:35:51"
691      },
692      {
693        "schedule_id": 3673,
694        "carrier_name": "MSC",
695        "carrier_scac": "MSCU",
696        "cargo_type": "GC",
697        "origin": {
698          "estimated_date": "2024-06-11 12:30:00",
699          "port_name": "GENOA",
700          "port_locode": "ITGOA",
701          "terminal_name": "BETTOLO CONTAINER TERMINAL",
702          "terminal_code": null
703        },
704        "destination": {
705          "estimated_date": "2024-06-21 22:15:00",
706          "port_name": "ALEXANDRIA OLD PORT",
707          "port_locode": "EGALY",
708          "terminal_name": "ALEXANDRIA OLD PORT",
709          "terminal_code": null
710        },
711        "legs": [
712          {
713            "order_id": 1,
714            "mode": "VESSEL",
715            "vessel_name": "MSC ELEONORA",
716            "vessel_imo": 9064750,
717            "voyages": [
718              {
719                "name": "voyage",
720                "voyage": "AC423A"
721              }
722            ],
723            "departure": {
724              "estimated_date": "2024-06-11 12:30:00",
725              "port_name": "GENOA",
726              "port_locode": "ITGOA",
727              "terminal_name": "BETTOLO CONTAINER TERMINAL",
728              "terminal_code": null
729            },
730            "arrival": {
731              "estimated_date": "2024-06-13 06:15:00",
732              "port_name": "GIOIA TAURO",
733              "port_locode": "ITGIT",
734              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
735              "terminal_code": null
736            },
737            "service_name": "LINE B",
738            "service_code": null
739          },
740          {
741            "order_id": 2,
742            "mode": "VESSEL",
743            "vessel_name": "MSC HARMONY III",
744            "vessel_imo": 9309411,
745            "voyages": [
746              {
747                "name": "voyage",
748                "voyage": "AB422A"
749              }
750            ],
751            "departure": {
752              "estimated_date": "2024-06-14 07:00:00",
753              "port_name": "GIOIA TAURO",
754              "port_locode": "ITGIT",
755              "terminal_name": "MEDCENTER CONTAINER TERMINAL",
756              "terminal_code": null
757            },
758            "arrival": {
759              "estimated_date": "2024-06-21 22:15:00",
760              "port_name": "ALEXANDRIA OLD PORT",
761              "port_locode": "EGALY",
762              "terminal_name": "ALEXANDRIA OLD PORT",
763              "terminal_code": null
764            },
765            "service_name": "ADRIATIC TO E - MED",
766            "service_code": null
767          }
768        ],
769        "cut_off_dates": [],
770        "transit_time": 10,
771        "direct": false,
772        "updated_at": "2024-05-10 12:35:51"
773      }
774    ]
775  }
776}

Schedules by Vessel

get/schedules/by-vessel

Get schedules for particular vessel using it's IMO number, and SCACs for carriers filter.

Headers

Content-Typeapplication/json

Query Parameters
  • carriersOptionalstring

    SCAC codes list

    Example:MAEU,MSCU,COSU,ONEY,HDMU,OOLU,YMLU,EGLV,CMDU

    Match pattern:^([A-Z0-9]{4}(?:(,[A-Z0-9]{4})){0,})$

  • imoREQUIREDinteger

    IMO code of the vessel

    Example:9588081

  • voyagesOptionalstring

    Voyage numbers list

    Example:057W,058E

Response example
Schedules by Vessel
1{
2  "success": true,
3  "status_code": "OK",
4  "metadata": {
5    "request_parameters": {
6      "carriers": "YMLU,OOLU",
7      "imo": 9588081,
8      "voyages": "058E,058W"
9    },
10    "response_stats": [
11      {
12        "status_code": "SCHEDULES_FOUND",
13        "carrier_name": "YANG MING",
14        "found_schedules": 1
15      },
16      {
17        "status_code": "SCHEDULES_FOUND",
18        "carrier_name": "OOCL",
19        "found_schedules": 1
20      }
21    ]
22  },
23  "data": {
24    "schedules": [
25      {
26        "schedule_id": 3296,
27        "carrier_name": "YANG MING",
28        "carrier_scac": "YMLU",
29        "vessel_name": "ONE HELSINKI",
30        "vessel_imo": 9588081,
31        "service_name": "FP1",
32        "service_code": "FP1",
33        "all_voyages": [
34          "058E",
35          "FP12406AB"
36        ],
37        "calling_ports": [
38          {
39            "order_id": 1,
40            "voyages": [
41              {
42                "name": "arrival",
43                "voyage": "058E"
44              },
45              {
46                "name": "arrival local",
47                "voyage": "FP12406AB"
48              },
49              {
50                "name": "departure",
51                "voyage": "058E"
52              },
53              {
54                "name": "departure local",
55                "voyage": "FP12406AB"
56              }
57            ],
58            "skip": false,
59            "estimated_dates": {
60              "arrival_date": null,
61              "berth_date": null,
62              "departure_date": null
63            },
64            "actual_dates": {
65              "arrival_date": "2024-04-13 23:00:00",
66              "berth_date": "2024-04-14 00:00:00",
67              "departure_date": "2024-04-14 22:00:00"
68            },
69            "port_name": "Busan, Busan Gwang'yeogsi [Pusan-Kwangyokshi]",
70            "port_locode": "KRPUS",
71            "terminal_name": "HMM PSA NEW-PORT TERMINAL",
72            "terminal_code": null,
73            "cut_off_dates": []
74          },
75          {
76            "order_id": 2,
77            "voyages": [
78              {
79                "name": "arrival",
80                "voyage": "058E"
81              },
82              {
83                "name": "arrival local",
84                "voyage": "FP12406AB"
85              },
86              {
87                "name": "departure",
88                "voyage": "058E"
89              },
90              {
91                "name": "departure local",
92                "voyage": "FP12406AB"
93              }
94            ],
95            "skip": false,
96            "estimated_dates": {
97              "arrival_date": null,
98              "berth_date": null,
99              "departure_date": null
100            },
101            "actual_dates": {
102              "arrival_date": "2024-04-16 13:30:00",
103              "berth_date": "2024-04-16 14:23:00",
104              "departure_date": "2024-04-17 01:48:00"
105            },
106            "port_name": "Kobe, Hyogo[Hyogo]",
107            "port_locode": "JPUKB",
108            "terminal_name": "PORT ISLAND PC16/17",
109            "terminal_code": null,
110            "cut_off_dates": []
111          },
112          {
113            "order_id": 3,
114            "voyages": [
115              {
116                "name": "arrival",
117                "voyage": "058E"
118              },
119              {
120                "name": "arrival local",
121                "voyage": "FP12406AB"
122              },
123              {
124                "name": "departure",
125                "voyage": "058E"
126              },
127              {
128                "name": "departure local",
129                "voyage": "FP12406AB"
130              }
131            ],
132            "skip": false,
133            "estimated_dates": {
134              "arrival_date": null,
135              "berth_date": null,
136              "departure_date": null
137            },
138            "actual_dates": {
139              "arrival_date": "2024-04-17 16:45:00",
140              "berth_date": "2024-04-17 20:15:00",
141              "departure_date": "2024-04-18 15:00:00"
142            },
143            "port_name": "Nagoya, Aiti [Aichi]",
144            "port_locode": "JPNGO",
145            "terminal_name": "TOBISHIMA CONTAINER BERTH",
146            "terminal_code": null,
147            "cut_off_dates": []
148          },
149          {
150            "order_id": 4,
151            "voyages": [
152              {
153                "name": "arrival",
154                "voyage": "058E"
155              },
156              {
157                "name": "arrival local",
158                "voyage": "FP12406AB"
159              },
160              {
161                "name": "departure",
162                "voyage": "058E"
163              },
164              {
165                "name": "departure local",
166                "voyage": "FP12406AB"
167              }
168            ],
169            "skip": false,
170            "estimated_dates": {
171              "arrival_date": null,
172              "berth_date": null,
173              "departure_date": null
174            },
175            "actual_dates": {
176              "arrival_date": "2024-04-19 06:57:00",
177              "berth_date": "2024-04-19 07:41:00",
178              "departure_date": "2024-04-20 16:23:00"
179            },
180            "port_name": "Tokyo, Tokyo [Tokyo]",
181            "port_locode": "JPTYO",
182            "terminal_name": "OHI NO. 6/7 NYK CONTAINER TERMINAL",
183            "terminal_code": null,
184            "cut_off_dates": []
185          },
186          {
187            "order_id": 5,
188            "voyages": [
189              {
190                "name": "arrival",
191                "voyage": "058E"
192              },
193              {
194                "name": "arrival local",
195                "voyage": "FP12406AB"
196              },
197              {
198                "name": "departure",
199                "voyage": "058E"
200              },
201              {
202                "name": "departure local",
203                "voyage": "FP12406AB"
204              }
205            ],
206            "skip": false,
207            "estimated_dates": {
208              "arrival_date": null,
209              "berth_date": null,
210              "departure_date": null
211            },
212            "actual_dates": {
213              "arrival_date": "2024-05-03 04:38:00",
214              "berth_date": "2024-05-03 05:55:00",
215              "departure_date": "2024-05-07 03:20:00"
216            },
217            "port_name": "Los Angeles, California",
218            "port_locode": "USLAX",
219            "terminal_name": "YUSEN TERMINAL",
220            "terminal_code": null,
221            "cut_off_dates": []
222          },
223          {
224            "order_id": 6,
225            "voyages": [
226              {
227                "name": "arrival",
228                "voyage": "058E"
229              },
230              {
231                "name": "arrival local",
232                "voyage": "FP12406AB"
233              },
234              {
235                "name": "departure",
236                "voyage": "058E"
237              },
238              {
239                "name": "departure local",
240                "voyage": "FP12406AB"
241              }
242            ],
243            "skip": false,
244            "estimated_dates": {
245              "arrival_date": "2024-05-09 05:00:00",
246              "berth_date": "2024-05-09 07:00:00",
247              "departure_date": "2024-05-10 17:00:00"
248            },
249            "actual_dates": {
250              "arrival_date": null,
251              "berth_date": null,
252              "departure_date": null
253            },
254            "port_name": "Oakland, California",
255            "port_locode": "USOAK",
256            "terminal_name": "TRAPAC, INC. (OAK)",
257            "terminal_code": null,
258            "cut_off_dates": []
259          },
260          {
261            "order_id": 7,
262            "voyages": [
263              {
264                "name": "arrival",
265                "voyage": "058E"
266              },
267              {
268                "name": "arrival local",
269                "voyage": "FP12406AB"
270              },
271              {
272                "name": "departure",
273                "voyage": "058E"
274              },
275              {
276                "name": "departure local",
277                "voyage": "FP12406AB"
278              }
279            ],
280            "skip": false,
281            "estimated_dates": {
282              "arrival_date": "2024-05-23 05:00:00",
283              "berth_date": "2024-05-23 08:00:00",
284              "departure_date": "2024-05-24 04:00:00"
285            },
286            "actual_dates": {
287              "arrival_date": null,
288              "berth_date": null,
289              "departure_date": null
290            },
291            "port_name": "Tokyo, Tokyo [Tokyo]",
292            "port_locode": "JPTYO",
293            "terminal_name": "TOKYO OHI TML",
294            "terminal_code": null,
295            "cut_off_dates": []
296          },
297          {
298            "order_id": 8,
299            "voyages": [
300              {
301                "name": "arrival",
302                "voyage": "058E"
303              },
304              {
305                "name": "arrival local",
306                "voyage": "FP12406AB"
307              },
308              {
309                "name": "departure",
310                "voyage": "058E"
311              },
312              {
313                "name": "departure local",
314                "voyage": "FP12406AB"
315              }
316            ],
317            "skip": false,
318            "estimated_dates": {
319              "arrival_date": "2024-05-26 05:00:00",
320              "berth_date": "2024-05-26 08:00:00",
321              "departure_date": "2024-05-27 03:00:00"
322            },
323            "actual_dates": {
324              "arrival_date": null,
325              "berth_date": null,
326              "departure_date": null
327            },
328            "port_name": "Kobe, Hyogo[Hyogo]",
329            "port_locode": "JPUKB",
330            "terminal_name": "ROKKO ISLAND C-6/7",
331            "terminal_code": null,
332            "cut_off_dates": []
333          },
334          {
335            "order_id": 9,
336            "voyages": [
337              {
338                "name": "arrival",
339                "voyage": "058E"
340              },
341              {
342                "name": "arrival local",
343                "voyage": "FP12406AB"
344              },
345              {
346                "name": "departure",
347                "voyage": "058E"
348              },
349              {
350                "name": "departure local",
351                "voyage": "FP12406AB"
352              }
353            ],
354            "skip": false,
355            "estimated_dates": {
356              "arrival_date": "2024-05-27 05:00:00",
357              "berth_date": "2024-05-27 08:00:00",
358              "departure_date": "2024-05-28 13:00:00"
359            },
360            "actual_dates": {
361              "arrival_date": null,
362              "berth_date": null,
363              "departure_date": null
364            },
365            "port_name": "Nagoya, Aiti [Aichi]",
366            "port_locode": "JPNGO",
367            "terminal_name": "TOBISHIMA CONTAINER BERTH",
368            "terminal_code": null,
369            "cut_off_dates": []
370          },
371          {
372            "order_id": 10,
373            "voyages": [
374              {
375                "name": "arrival",
376                "voyage": "058E"
377              },
378              {
379                "name": "arrival local",
380                "voyage": "FP12406AB"
381              },
382              {
383                "name": "departure",
384                "voyage": "058E"
385              },
386              {
387                "name": "departure local",
388                "voyage": "FP12406AB"
389              }
390            ],
391            "skip": false,
392            "estimated_dates": {
393              "arrival_date": "2024-05-30 02:00:00",
394              "berth_date": "2024-05-30 04:00:00",
395              "departure_date": "2024-05-31 00:00:00"
396            },
397            "actual_dates": {
398              "arrival_date": null,
399              "berth_date": null,
400              "departure_date": null
401            },
402            "port_name": "Busan, Busan Gwang'yeogsi [Pusan-Kwangyokshi]",
403            "port_locode": "KRPUS",
404            "terminal_name": "HMM PSA NEW-PORT TERMINAL",
405            "terminal_code": null,
406            "cut_off_dates": []
407          }
408        ],
409        "updated_at": "2024-05-10 12:41:37"
410      },
411      {
412        "schedule_id": 2747,
413        "carrier_name": "OOCL",
414        "carrier_scac": "OOLU",
415        "vessel_name": "ONE HELSINKI",
416        "vessel_imo": 9588081,
417        "service_name": "JPX",
418        "service_code": "JPX",
419        "all_voyages": [
420          "057W",
421          "058E",
422          "058W",
423          "059E",
424          "059W"
425        ],
426        "calling_ports": [
427          {
428            "order_id": 1,
429            "voyages": [
430              {
431                "name": "arrival",
432                "voyage": "057W"
433              },
434              {
435                "name": "departure",
436                "voyage": "057W"
437              }
438            ],
439            "skip": false,
440            "estimated_dates": {
441              "arrival_date": null,
442              "berth_date": null,
443              "departure_date": null
444            },
445            "actual_dates": {
446              "arrival_date": "2024-04-10 08:21:00",
447              "berth_date": null,
448              "departure_date": "2024-04-10 17:40:00"
449            },
450            "port_name": "Nagoya, Aiti [Aichi]",
451            "port_locode": "JPNGO",
452            "terminal_name": null,
453            "terminal_code": null,
454            "cut_off_dates": []
455          },
456          {
457            "order_id": 2,
458            "voyages": [
459              {
460                "name": "arrival",
461                "voyage": "058E"
462              },
463              {
464                "name": "departure",
465                "voyage": "058E"
466              }
467            ],
468            "skip": false,
469            "estimated_dates": {
470              "arrival_date": null,
471              "berth_date": null,
472              "departure_date": null
473            },
474            "actual_dates": {
475              "arrival_date": "2024-04-16 14:38:00",
476              "berth_date": null,
477              "departure_date": "2024-04-17 02:00:00"
478            },
479            "port_name": "Kobe, Hyogo[Hyogo]",
480            "port_locode": "JPUKB",
481            "terminal_name": null,
482            "terminal_code": null,
483            "cut_off_dates": []
484          },
485          {
486            "order_id": 3,
487            "voyages": [
488              {
489                "name": "arrival",
490                "voyage": "058E"
491              },
492              {
493                "name": "departure",
494                "voyage": "058E"
495              }
496            ],
497            "skip": false,
498            "estimated_dates": {
499              "arrival_date": null,
500              "berth_date": null,
501              "departure_date": null
502            },
503            "actual_dates": {
504              "arrival_date": "2024-04-17 20:08:00",
505              "berth_date": null,
506              "departure_date": "2024-04-18 14:57:00"
507            },
508            "port_name": "Nagoya, Aiti [Aichi]",
509            "port_locode": "JPNGO",
510            "terminal_name": null,
511            "terminal_code": null,
512            "cut_off_dates": []
513          },
514          {
515            "order_id": 4,
516            "voyages": [
517              {
518                "name": "arrival",
519                "voyage": "058E"
520              },
521              {
522                "name": "departure",
523                "voyage": "058E"
524              }
525            ],
526            "skip": false,
527            "estimated_dates": {
528              "arrival_date": null,
529              "berth_date": null,
530              "departure_date": null
531            },
532            "actual_dates": {
533              "arrival_date": "2024-04-19 07:47:00",
534              "berth_date": null,
535              "departure_date": "2024-04-20 16:30:00"
536            },
537            "port_name": "Tokyo, Tokyo [Tokyo]",
538            "port_locode": "JPTYO",
539            "terminal_name": null,
540            "terminal_code": null,
541            "cut_off_dates": []
542          },
543          {
544            "order_id": 5,
545            "voyages": [
546              {
547                "name": "arrival",
548                "voyage": "058W"
549              },
550              {
551                "name": "departure",
552                "voyage": "058W"
553              }
554            ],
555            "skip": false,
556            "estimated_dates": {
557              "arrival_date": null,
558              "berth_date": null,
559              "departure_date": null
560            },
561            "actual_dates": {
562              "arrival_date": "2024-05-03 05:59:00",
563              "berth_date": null,
564              "departure_date": "2024-05-07 03:12:00"
565            },
566            "port_name": "Los Angeles, California",
567            "port_locode": "USLAX",
568            "terminal_name": null,
569            "terminal_code": null,
570            "cut_off_dates": []
571          },
572          {
573            "order_id": 6,
574            "voyages": [
575              {
576                "name": "arrival",
577                "voyage": "058W"
578              },
579              {
580                "name": "departure",
581                "voyage": "058W"
582              }
583            ],
584            "skip": false,
585            "estimated_dates": {
586              "arrival_date": "2024-05-09 07:00:00",
587              "berth_date": null,
588              "departure_date": "2024-05-10 17:00:00"
589            },
590            "actual_dates": {
591              "arrival_date": null,
592              "berth_date": null,
593              "departure_date": null
594            },
595            "port_name": "Oakland, California",
596            "port_locode": "USOAK",
597            "terminal_name": null,
598            "terminal_code": null,
599            "cut_off_dates": []
600          },
601          {
602            "order_id": 7,
603            "voyages": [
604              {
605                "name": "arrival",
606                "voyage": "058W"
607              },
608              {
609                "name": "departure",
610                "voyage": "058W"
611              }
612            ],
613            "skip": false,
614            "estimated_dates": {
615              "arrival_date": "2024-05-23 08:00:00",
616              "berth_date": null,
617              "departure_date": "2024-05-24 04:00:00"
618            },
619            "actual_dates": {
620              "arrival_date": null,
621              "berth_date": null,
622              "departure_date": null
623            },
624            "port_name": "Tokyo, Tokyo [Tokyo]",
625            "port_locode": "JPTYO",
626            "terminal_name": null,
627            "terminal_code": null,
628            "cut_off_dates": []
629          },
630          {
631            "order_id": 8,
632            "voyages": [
633              {
634                "name": "arrival",
635                "voyage": "058W"
636              },
637              {
638                "name": "departure",
639                "voyage": "058W"
640              }
641            ],
642            "skip": false,
643            "estimated_dates": {
644              "arrival_date": "2024-05-25 08:00:00",
645              "berth_date": null,
646              "departure_date": "2024-05-26 03:00:00"
647            },
648            "actual_dates": {
649              "arrival_date": null,
650              "berth_date": null,
651              "departure_date": null
652            },
653            "port_name": "Kobe, Hyogo[Hyogo]",
654            "port_locode": "JPUKB",
655            "terminal_name": null,
656            "terminal_code": null,
657            "cut_off_dates": []
658          },
659          {
660            "order_id": 9,
661            "voyages": [
662              {
663                "name": "arrival",
664                "voyage": "058W"
665              },
666              {
667                "name": "departure",
668                "voyage": "058W"
669              }
670            ],
671            "skip": false,
672            "estimated_dates": {
673              "arrival_date": "2024-05-26 19:00:00",
674              "berth_date": null,
675              "departure_date": "2024-05-27 17:00:00"
676            },
677            "actual_dates": {
678              "arrival_date": null,
679              "berth_date": null,
680              "departure_date": null
681            },
682            "port_name": "Nagoya, Aiti [Aichi]",
683            "port_locode": "JPNGO",
684            "terminal_name": null,
685            "terminal_code": null,
686            "cut_off_dates": []
687          },
688          {
689            "order_id": 10,
690            "voyages": [
691              {
692                "name": "arrival",
693                "voyage": "059E"
694              },
695              {
696                "name": "departure",
697                "voyage": "059E"
698              }
699            ],
700            "skip": false,
701            "estimated_dates": {
702              "arrival_date": "2024-05-31 19:00:00",
703              "berth_date": null,
704              "departure_date": "2024-06-02 00:00:00"
705            },
706            "actual_dates": {
707              "arrival_date": null,
708              "berth_date": null,
709              "departure_date": null
710            },
711            "port_name": "Kobe, Hyogo[Hyogo]",
712            "port_locode": "JPUKB",
713            "terminal_name": null,
714            "terminal_code": null,
715            "cut_off_dates": []
716          },
717          {
718            "order_id": 11,
719            "voyages": [
720              {
721                "name": "arrival",
722                "voyage": "059E"
723              },
724              {
725                "name": "departure",
726                "voyage": "059E"
727              }
728            ],
729            "skip": false,
730            "estimated_dates": {
731              "arrival_date": "2024-06-03 08:00:00",
732              "berth_date": null,
733              "departure_date": "2024-06-04 14:00:00"
734            },
735            "actual_dates": {
736              "arrival_date": null,
737              "berth_date": null,
738              "departure_date": null
739            },
740            "port_name": "Nagoya, Aiti [Aichi]",
741            "port_locode": "JPNGO",
742            "terminal_name": null,
743            "terminal_code": null,
744            "cut_off_dates": []
745          },
746          {
747            "order_id": 12,
748            "voyages": [
749              {
750                "name": "arrival",
751                "voyage": "059E"
752              },
753              {
754                "name": "departure",
755                "voyage": "059E"
756              }
757            ],
758            "skip": false,
759            "estimated_dates": {
760              "arrival_date": "2024-06-06 00:00:00",
761              "berth_date": null,
762              "departure_date": "2024-06-07 21:00:00"
763            },
764            "actual_dates": {
765              "arrival_date": null,
766              "berth_date": null,
767              "departure_date": null
768            },
769            "port_name": "Tokyo, Tokyo [Tokyo]",
770            "port_locode": "JPTYO",
771            "terminal_name": null,
772            "terminal_code": null,
773            "cut_off_dates": []
774          },
775          {
776            "order_id": 13,
777            "voyages": [
778              {
779                "name": "arrival",
780                "voyage": "059W"
781              },
782              {
783                "name": "departure",
784                "voyage": "059W"
785              }
786            ],
787            "skip": false,
788            "estimated_dates": {
789              "arrival_date": "2024-06-19 18:00:00",
790              "berth_date": null,
791              "departure_date": "2024-06-24 03:00:00"
792            },
793            "actual_dates": {
794              "arrival_date": null,
795              "berth_date": null,
796              "departure_date": null
797            },
798            "port_name": "Los Angeles, California",
799            "port_locode": "USLAX",
800            "terminal_name": null,
801            "terminal_code": null,
802            "cut_off_dates": []
803          },
804          {
805            "order_id": 14,
806            "voyages": [
807              {
808                "name": "arrival",
809                "voyage": "059W"
810              },
811              {
812                "name": "departure",
813                "voyage": "059W"
814              }
815            ],
816            "skip": false,
817            "estimated_dates": {
818              "arrival_date": "2024-06-25 08:00:00",
819              "berth_date": null,
820              "departure_date": "2024-06-26 17:00:00"
821            },
822            "actual_dates": {
823              "arrival_date": null,
824              "berth_date": null,
825              "departure_date": null
826            },
827            "port_name": "Oakland, California",
828            "port_locode": "USOAK",
829            "terminal_name": null,
830            "terminal_code": null,
831            "cut_off_dates": []
832          }
833        ],
834        "updated_at": "2024-05-10 12:41:37"
835      }
836    ]
837  }
838}

Schedules by Port

get/schedules/by-port

Get schedules for particular port using it's UN/LOCODE, and SCACs for carriers filter.

Headers

Content-Typeapplication/json

Query Parameters
  • carriersOptionalstring

    SCAC codes list

    Example:MAEU,MSCU,COSU,ONEY,HDMU,OOLU,YMLU,EGLV,CMDU

    Match pattern:^([A-Z0-9]{4}(?:(,[A-Z0-9]{4})){0,})$

  • locodeREQUIREDstring

    Port UN/LOCODE

    Example:USNYC

    Match pattern:^[A-Z0-9]{5}$

  • from_dateREQUIREDstring

    Start from date - specify the date in format yyyy-mm-dd. Must be current date or future date

    Example:2024-04-02

    Match pattern:^(\d{4}-\d{2}-\d{2})$

  • weeksREQUIREDinteger

    Weeks ahead to display

    >= 1<= 6

    Example:3

Response example
Schedules by Port
1{
2  "success": true,
3  "status_code": "OK",
4  "metadata": {
5    "request_parameters": {
6      "carriers": "MSCU",
7      "locode": "USNYC",
8      "from_date": "2024-08-15",
9      "weeks": 1
10    },
11    "response_stats": [
12      {
13        "status_code": "SCHEDULES_FOUND",
14        "carrier_name": "MSC",
15        "found_schedules": 1
16      }
17    ]
18  },
19  "data": {
20    "schedules": [
21      {
22        "schedule_id": "07bf0d4adb8c242aad4582ca9a62d7d4bc1a8a4e",
23        "carrier_name": "MSC",
24        "carrier_scac": "MSCU",
25        "port_name": "NEW YORK",
26        "port_locode": "USNYC",
27        "all_voyages": [
28          "CG429R",
29          "PH432R",
30          "IU432R",
31          "432W",
32          "MZ432R",
33          "UL430W",
34          "XA425A",
35          "XA431R",
36          "NG430W",
37          "ME429W",
38          "ME433E",
39          "427W",
40          "433E",
41          "431E",
42          "IU426A",
43          "IU433R",
44          "NN429A",
45          "428E",
46          "433W",
47          "431W",
48          "PD432A",
49          "432E",
50          "CG430R",
51          "UZ432S",
52          "ME430W",
53          "ME434E",
54          "MZ433R",
55          "IU427A"
56        ],
57        "calling_vessels": [
58          {
59            "order_id": 1,
60            "voyages": [
61              {
62                "name": "Departure Voyage",
63                "voyage": "CG429R"
64              }
65            ],
66            "skip": false,
67            "estimated_dates": {
68              "arrival_date": null,
69              "berth_date": null,
70              "departure_date": "2024-08-13 03:36:00"
71            },
72            "actual_dates": {
73              "arrival_date": null,
74              "berth_date": null,
75              "departure_date": null
76            },
77            "vessel_name": "MSC BALTIC III",
78            "vessel_imo": 9241475,
79            "terminal_name": null,
80            "terminal_code": null,
81            "service_name": "CANADA GULF BRIDGE",
82            "service_code": null,
83            "cut_off_dates": []
84          },
85          {
86            "order_id": 2,
87            "voyages": [
88              {
89                "name": "Departure Voyage",
90                "voyage": "PH432R"
91              }
92            ],
93            "skip": false,
94            "estimated_dates": {
95              "arrival_date": null,
96              "berth_date": null,
97              "departure_date": "2024-08-13 06:00:00"
98            },
99            "actual_dates": {
100              "arrival_date": null,
101              "berth_date": null,
102              "departure_date": null
103            },
104            "vessel_name": "MSC PASSION III",
105            "vessel_imo": null,
106            "terminal_name": null,
107            "terminal_code": null,
108            "service_name": "PHILADELPHIA EXPRESS",
109            "service_code": null,
110            "cut_off_dates": []
111          },
112          {
113            "order_id": 3,
114            "voyages": [
115              {
116                "name": "Arrival Voyage",
117                "voyage": "IU432R"
118              },
119              {
120                "name": "Departure Voyage",
121                "voyage": "IU432R"
122              }
123            ],
124            "skip": false,
125            "estimated_dates": {
126              "arrival_date": "2024-08-13 16:00:00",
127              "berth_date": null,
128              "departure_date": "2024-08-15 17:00:00"
129            },
130            "actual_dates": {
131              "arrival_date": null,
132              "berth_date": null,
133              "departure_date": null
134            },
135            "vessel_name": "KOTKA",
136            "vessel_imo": null,
137            "terminal_name": null,
138            "terminal_code": null,
139            "service_name": "INDUS EXPRESS",
140            "service_code": null,
141            "cut_off_dates": []
142          },
143          {
144            "order_id": 4,
145            "voyages": [
146              {
147                "name": "Departure Voyage",
148                "voyage": "432W"
149              }
150            ],
151            "skip": false,
152            "estimated_dates": {
153              "arrival_date": null,
154              "berth_date": null,
155              "departure_date": "2024-08-13 23:33:00"
156            },
157            "actual_dates": {
158              "arrival_date": null,
159              "berth_date": null,
160              "departure_date": null
161            },
162            "vessel_name": "MAERSK SINGAPORE",
163            "vessel_imo": 9308649,
164            "terminal_name": null,
165            "terminal_code": null,
166            "service_name": "EMPIRE",
167            "service_code": null,
168            "cut_off_dates": []
169          },
170          {
171            "order_id": 5,
172            "voyages": [
173              {
174                "name": "Departure Voyage",
175                "voyage": "MZ432R"
176              }
177            ],
178            "skip": false,
179            "estimated_dates": {
180              "arrival_date": null,
181              "berth_date": null,
182              "departure_date": "2024-08-14 01:00:00"
183            },
184            "actual_dates": {
185              "arrival_date": null,
186              "berth_date": null,
187              "departure_date": null
188            },
189            "vessel_name": "MSC SHRISTI",
190            "vessel_imo": 9293442,
191            "terminal_name": null,
192            "terminal_code": null,
193            "service_name": "EMUSA",
194            "service_code": null,
195            "cut_off_dates": []
196          },
197          {
198            "order_id": 6,
199            "voyages": [
200              {
201                "name": "Arrival Voyage",
202                "voyage": "UL430W"
203              },
204              {
205                "name": "Departure Voyage",
206                "voyage": "UL430W"
207              }
208            ],
209            "skip": false,
210            "estimated_dates": {
211              "arrival_date": "2024-08-14 05:00:00",
212              "berth_date": null,
213              "departure_date": "2024-08-15 21:00:00"
214            },
215            "actual_dates": {
216              "arrival_date": null,
217              "berth_date": null,
218              "departure_date": null
219            },
220            "vessel_name": "MSC COTONOU VIII",
221            "vessel_imo": null,
222            "terminal_name": null,
223            "terminal_code": null,
224            "service_name": "EMERALD",
225            "service_code": null,
226            "cut_off_dates": []
227          },
228          {
229            "order_id": 7,
230            "voyages": [
231              {
232                "name": "Arrival Voyage",
233                "voyage": "XA425A"
234              },
235              {
236                "name": "Departure Voyage",
237                "voyage": "XA431R"
238              }
239            ],
240            "skip": false,
241            "estimated_dates": {
242              "arrival_date": "2024-08-14 10:30:00",
243              "berth_date": null,
244              "departure_date": "2024-08-16 15:30:00"
245            },
246            "actual_dates": {
247              "arrival_date": null,
248              "berth_date": null,
249              "departure_date": null
250            },
251            "vessel_name": "MSC ANS",
252            "vessel_imo": null,
253            "terminal_name": null,
254            "terminal_code": null,
255            "service_name": "EXTRA VESSELS",
256            "service_code": null,
257            "cut_off_dates": []
258          },
259          {
260            "order_id": 8,
261            "voyages": [
262              {
263                "name": "Arrival Voyage",
264                "voyage": "NG430W"
265              },
266              {
267                "name": "Departure Voyage",
268                "voyage": "NG430W"
269              }
270            ],
271            "skip": false,
272            "estimated_dates": {
273              "arrival_date": "2024-08-14 11:30:00",
274              "berth_date": null,
275              "departure_date": "2024-08-16 00:00:00"
276            },
277            "actual_dates": {
278              "arrival_date": null,
279              "berth_date": null,
280              "departure_date": null
281            },
282            "vessel_name": "MSC VIGO",
283            "vessel_imo": null,
284            "terminal_name": null,
285            "terminal_code": null,
286            "service_name": "NEUATL3",
287            "service_code": null,
288            "cut_off_dates": []
289          },
290          {
291            "order_id": 9,
292            "voyages": [
293              {
294                "name": "Arrival Voyage",
295                "voyage": "ME429W"
296              },
297              {
298                "name": "Departure Voyage",
299                "voyage": "ME433E"
300              }
301            ],
302            "skip": false,
303            "estimated_dates": {
304              "arrival_date": "2024-08-16 06:00:00",
305              "berth_date": null,
306              "departure_date": "2024-08-17 21:00:00"
307            },
308            "actual_dates": {
309              "arrival_date": null,
310              "berth_date": null,
311              "departure_date": null
312            },
313            "vessel_name": "MSC PINA",
314            "vessel_imo": null,
315            "terminal_name": null,
316            "terminal_code": null,
317            "service_name": "MEDUSEC",
318            "service_code": null,
319            "cut_off_dates": []
320          },
321          {
322            "order_id": 10,
323            "voyages": [
324              {
325                "name": "Arrival Voyage",
326                "voyage": "427W"
327              },
328              {
329                "name": "Departure Voyage",
330                "voyage": "433E"
331              }
332            ],
333            "skip": false,
334            "estimated_dates": {
335              "arrival_date": "2024-08-16 06:00:00",
336              "berth_date": null,
337              "departure_date": "2024-08-17 04:00:00"
338            },
339            "actual_dates": {
340              "arrival_date": null,
341              "berth_date": null,
342              "departure_date": null
343            },
344            "vessel_name": "GERDA MAERSK",
345            "vessel_imo": 9359052,
346            "terminal_name": null,
347            "terminal_code": null,
348            "service_name": "AMERICA",
349            "service_code": null,
350            "cut_off_dates": []
351          },
352          {
353            "order_id": 11,
354            "voyages": [
355              {
356                "name": "Arrival Voyage",
357                "voyage": "431E"
358              },
359              {
360                "name": "Departure Voyage",
361                "voyage": "431E"
362              }
363            ],
364            "skip": false,
365            "estimated_dates": {
366              "arrival_date": "2024-08-16 06:00:00",
367              "berth_date": null,
368              "departure_date": "2024-08-17 09:00:00"
369            },
370            "actual_dates": {
371              "arrival_date": null,
372              "berth_date": null,
373              "departure_date": null
374            },
375            "vessel_name": "MAERSK GIRONDE",
376            "vessel_imo": null,
377            "terminal_name": null,
378            "terminal_code": null,
379            "service_name": "NEUATL2",
380            "service_code": null,
381            "cut_off_dates": []
382          },
383          {
384            "order_id": 12,
385            "voyages": [
386              {
387                "name": "Arrival Voyage",
388                "voyage": "IU426A"
389              },
390              {
391                "name": "Departure Voyage",
392                "voyage": "IU433R"
393              }
394            ],
395            "skip": false,
396            "estimated_dates": {
397              "arrival_date": "2024-08-16 18:00:00",
398              "berth_date": null,
399              "departure_date": "2024-08-17 12:00:00"
400            },
401            "actual_dates": {
402              "arrival_date": null,
403              "berth_date": null,
404              "departure_date": null
405            },
406            "vessel_name": "MSC TEMA VIII",
407            "vessel_imo": null,
408            "terminal_name": null,
409            "terminal_code": null,
410            "service_name": "INDUS EXPRESS",
411            "service_code": null,
412            "cut_off_dates": []
413          },
414          {
415            "order_id": 13,
416            "voyages": [
417              {
418                "name": "Arrival Voyage",
419                "voyage": "NN429A"
420              },
421              {
422                "name": "Departure Voyage",
423                "voyage": "NN429A"
424              }
425            ],
426            "skip": false,
427            "estimated_dates": {
428              "arrival_date": "2024-08-17 06:00:00",
429              "berth_date": null,
430              "departure_date": "2024-08-18 03:00:00"
431            },
432            "actual_dates": {
433              "arrival_date": null,
434              "berth_date": null,
435              "departure_date": null
436            },
437            "vessel_name": "MSC RONIT R",
438            "vessel_imo": 9293167,
439            "terminal_name": null,
440            "terminal_code": null,
441            "service_name": "ECUADOR - NWC & SCAN BALTIC - USA",
442            "service_code": null,
443            "cut_off_dates": []
444          },
445          {
446            "order_id": 14,
447            "voyages": [
448              {
449                "name": "Arrival Voyage",
450                "voyage": "428E"
451              },
452              {
453                "name": "Departure Voyage",
454                "voyage": "433W"
455              }
456            ],
457            "skip": false,
458            "estimated_dates": {
459              "arrival_date": "2024-08-17 07:00:00",
460              "berth_date": null,
461              "departure_date": "2024-08-19 15:00:00"
462            },
463            "actual_dates": {
464              "arrival_date": null,
465              "berth_date": null,
466              "departure_date": null
467            },
468            "vessel_name": "MAERSK TAURUS",
469            "vessel_imo": 9334674,
470            "terminal_name": null,
471            "terminal_code": null,
472            "service_name": "EMPIRE",
473            "service_code": null,
474            "cut_off_dates": []
475          },
476          {
477            "order_id": 15,
478            "voyages": [
479              {
480                "name": "Arrival Voyage",
481                "voyage": "431W"
482              },
483              {
484                "name": "Departure Voyage",
485                "voyage": "431W"
486              }
487            ],
488            "skip": false,
489            "estimated_dates": {
490              "arrival_date": "2024-08-17 07:00:00",
491              "berth_date": null,
492              "departure_date": "2024-08-18 03:00:00"
493            },
494            "actual_dates": {
495              "arrival_date": null,
496              "berth_date": null,
497              "departure_date": null
498            },
499            "vessel_name": "ORCA I",
500            "vessel_imo": 9318113,
501            "terminal_name": null,
502            "terminal_code": null,
503            "service_name": "NEUATL2",
504            "service_code": null,
505            "cut_off_dates": []
506          },
507          {
508            "order_id": 16,
509            "voyages": [
510              {
511                "name": "Arrival Voyage",
512                "voyage": "PD432A"
513              },
514              {
515                "name": "Departure Voyage",
516                "voyage": "PD432A"
517              }
518            ],
519            "skip": false,
520            "estimated_dates": {
521              "arrival_date": "2024-08-18 04:00:00",
522              "berth_date": null,
523              "departure_date": "2024-08-19 03:00:00"
524            },
525            "actual_dates": {
526              "arrival_date": null,
527              "berth_date": null,
528              "departure_date": null
529            },
530            "vessel_name": "LORI",
531            "vessel_imo": 9631125,
532            "terminal_name": null,
533            "terminal_code": null,
534            "service_name": "FLORIDA FEEDER",
535            "service_code": null,
536            "cut_off_dates": []
537          },
538          {
539            "order_id": 17,
540            "voyages": [
541              {
542                "name": "Arrival Voyage",
543                "voyage": "432E"
544              },
545              {
546                "name": "Departure Voyage",
547                "voyage": "432E"
548              }
549            ],
550            "skip": false,
551            "estimated_dates": {
552              "arrival_date": "2024-08-18 21:00:00",
553              "berth_date": null,
554              "departure_date": "2024-08-19 21:00:00"
555            },
556            "actual_dates": {
557              "arrival_date": null,
558              "berth_date": null,
559              "departure_date": null
560            },
561            "vessel_name": "MAERSK MAKUTU",
562            "vessel_imo": null,
563            "terminal_name": null,
564            "terminal_code": null,
565            "service_name": "NEUATL2",
566            "service_code": null,
567            "cut_off_dates": []
568          },
569          {
570            "order_id": 18,
571            "voyages": [
572              {
573                "name": "Arrival Voyage",
574                "voyage": "CG430R"
575              },
576              {
577                "name": "Departure Voyage",
578                "voyage": "CG430R"
579              }
580            ],
581            "skip": false,
582            "estimated_dates": {
583              "arrival_date": "2024-08-19 06:00:00",
584              "berth_date": null,
585              "departure_date": "2024-08-20 09:00:00"
586            },
587            "actual_dates": {
588              "arrival_date": null,
589              "berth_date": null,
590              "departure_date": null
591            },
592            "vessel_name": "MSC SAGITTA III",
593            "vessel_imo": 9401166,
594            "terminal_name": null,
595            "terminal_code": null,
596            "service_name": "CANADA GULF BRIDGE",
597            "service_code": null,
598            "cut_off_dates": []
599          },
600          {
601            "order_id": 19,
602            "voyages": [
603              {
604                "name": "Arrival Voyage",
605                "voyage": "UZ432S"
606              },
607              {
608                "name": "Departure Voyage",
609                "voyage": "UZ432S"
610              }
611            ],
612            "skip": false,
613            "estimated_dates": {
614              "arrival_date": "2024-08-19 11:32:00",
615              "berth_date": null,
616              "departure_date": "2024-08-20 01:02:00"
617            },
618            "actual_dates": {
619              "arrival_date": null,
620              "berth_date": null,
621              "departure_date": null
622            },
623            "vessel_name": "MSC JERSEY",
624            "vessel_imo": 9622007,
625            "terminal_name": null,
626            "terminal_code": null,
627            "service_name": "USA TO SOUTH AFRICA",
628            "service_code": null,
629            "cut_off_dates": []
630          },
631          {
632            "order_id": 20,
633            "voyages": [
634              {
635                "name": "Arrival Voyage",
636                "voyage": "ME430W"
637              },
638              {
639                "name": "Departure Voyage",
640                "voyage": "ME434E"
641              }
642            ],
643            "skip": false,
644            "estimated_dates": {
645              "arrival_date": "2024-08-19 17:00:00",
646              "berth_date": null,
647              "departure_date": "2024-08-21 06:00:00"
648            },
649            "actual_dates": {
650              "arrival_date": null,
651              "berth_date": null,
652              "departure_date": null
653            },
654            "vessel_name": "MSC NIOVI VIII",
655            "vessel_imo": null,
656            "terminal_name": null,
657            "terminal_code": null,
658            "service_name": "MEDUSEC",
659            "service_code": null,
660            "cut_off_dates": []
661          },
662          {
663            "order_id": 21,
664            "voyages": [
665              {
666                "name": "Arrival Voyage",
667                "voyage": "MZ433R"
668              }
669            ],
670            "skip": false,
671            "estimated_dates": {
672              "arrival_date": "2024-08-21 06:00:00",
673              "berth_date": null,
674              "departure_date": null
675            },
676            "actual_dates": {
677              "arrival_date": null,
678              "berth_date": null,
679              "departure_date": null
680            },
681            "vessel_name": "MSC MATILDE V",
682            "vessel_imo": null,
683            "terminal_name": null,
684            "terminal_code": null,
685            "service_name": "EMUSA",
686            "service_code": null,
687            "cut_off_dates": []
688          },
689          {
690            "order_id": 22,
691            "voyages": [
692              {
693                "name": "Arrival Voyage",
694                "voyage": "427W"
695              }
696            ],
697            "skip": false,
698            "estimated_dates": {
699              "arrival_date": "2024-08-21 07:00:00",
700              "berth_date": null,
701              "departure_date": null
702            },
703            "actual_dates": {
704              "arrival_date": null,
705              "berth_date": null,
706              "departure_date": null
707            },
708            "vessel_name": "MAERSK KOWLOON",
709            "vessel_imo": 9290476,
710            "terminal_name": null,
711            "terminal_code": null,
712            "service_name": "ELEPHANT",
713            "service_code": null,
714            "cut_off_dates": []
715          },
716          {
717            "order_id": 23,
718            "voyages": [
719              {
720                "name": "Arrival Voyage",
721                "voyage": "IU427A"
722              }
723            ],
724            "skip": false,
725            "estimated_dates": {
726              "arrival_date": "2024-08-21 11:00:00",
727              "berth_date": null,
728              "departure_date": null
729            },
730            "actual_dates": {
731              "arrival_date": null,
732              "berth_date": null,
733              "departure_date": null
734            },
735            "vessel_name": "MSC MUNDRA VIII",
736            "vessel_imo": 9294989,
737            "terminal_name": null,
738            "terminal_code": null,
739            "service_name": "INDUS EXPRESS",
740            "service_code": null,
741            "cut_off_dates": []
742          }
743        ],
744        "updated_at": "2024-08-16 12:02:19"
745      }
746    ]
747  }
748}

Get carriers list

get/carriers

Get list of all carriers in schedules system

Headers

Content-Typeapplication/json

Query Parameters
  • schedule_typeOptionalstring

    Filter carriers by supported schedules types:

    • BY_POINTS - get list of carriers for Schedules by Points
    • BY_VESSEL - get list of carriers for Schedules by Vessel

    Allowed values:BY_POINTSBY_VESSEL

  • cargo_typeOptionalstring

    Filter carriers by supported cargo types:

    • GC - General cargo
    • REEF - Reefer
    • RORO - Ro-Ro
    • LCL - Less container load

    Allowed values:GCREEFROROLCL

Response example
A list of carriers
1{
2  "success": true,
3  "status_code": "OK",
4  "data": {
5    "carriers": [
6      {
7        "name": "MAERSK",
8        "category": "Deep Sea",
9        "scac_codes": [
10          "MAEU"
11        ],
12        "supported_schedule_types": [
13          "BY_POINTS"
14        ],
15        "supported_cargo_types": [
16          "GC"
17        ],
18        "active": true,
19        "maintenance": {
20          "by_points": false,
21          "by_vessel": false
22        }
23      }
24    ]
25  }
26}

Get carrier entry

get/carriers/{scac}

Get carrier entry

Headers

Content-Typeapplication/json

Path Parameters
  • scacREQUIREDstring

    SCAC

    Example:MAEU

    Match pattern:^[A-Z0-9]{4}$

Response example
Carrier detailed information
1{
2  "success": true,
3  "status_code": "OK",
4  "data": {
5    "carrier": {
6      "name": "MAERSK",
7      "category": "Deep Sea",
8      "scac_codes": [
9        "MAEU"
10      ],
11      "supported_schedule_types": [
12        "BY_POINTS"
13      ],
14      "supported_cargo_types": [
15        "GC"
16      ],
17      "active": true,
18      "maintenance": {
19        "by_points": false,
20        "by_vessel": false
21      }
22    }
23  }
24}

Get vessel entry

get/vessels/{imo}

Get detailed information on vessel

Headers

Content-Typeapplication/json

Path Parameters
  • imoREQUIREDinteger

    IMO

    Example:9588081

Response example
Vessel detailed information
1{
2  "success": true,
3  "status_code": "OK",
4  "data": {
5    "vessel": {
6      "name": "ONE HELSINKI",
7      "imo": 9588081,
8      "call_sign": "3FIW4",
9      "mmsi": 373119000,
10      "flag": "PA",
11      "year_built": 2012,
12      "capacity_teu": 8930
13    }
14  }
15}

Get port entry

get/ports/{locode}

Get detailed information on port

Headers

Content-Typeapplication/json

Path Parameters
  • locodeREQUIREDstring

    UN/LOCODE

    Example:USNYC

    Match pattern:^[A-Z0-9]{5}$

Response example
Port detailed information
1{
2  "success": true,
3  "status_code": "OK",
4  "data": {
5    "port": {
6      "name": "New York",
7      "state": "New York",
8      "country": "United States",
9      "country_code": "US",
10      "locode": "USNYC",
11      "lat": 40.6759,
12      "lng": -74.0829,
13      "timezone": "America/New_York"
14    }
15  }
16}

Get api usage info

get/usage

Get api usage info

Headers

Content-Typeapplication/json

Response example
Usage info
1{
2  "success": true,
3  "status_code": "OK",
4  "data": {
5    "calls": {
6      "total": 3000,
7      "used": 20,
8      "remaining": 2980
9    },
10    "calls_by_type": {
11      "by_points": 10,
12      "by_vessel": 10
13    },
14    "expires_on": "2026-02-28 00:00:00"
15  }
16}