π’ο»Ώ Schedules routing via COGH and Suez, accurate historical traces, and container types supported
π July/August 2025
In this release, we focused on research topics for /v3/routes
. Alongside this, we delivered routing adjustments for schedules, improved historical traces, and expanded the container types supported in the Shipment API.
π Overview
π± Carbon Emissions APIs
Shipment API supported container types
We expanded our supported container types in /shipment/v2/report/co2
, and corrected the emissions for NOR (Non-Operating Reefer) containers. Previously, NOR was calculated as a reefer. Although technically a reefer, a NOR is not plugged in during transport, so its emissions are now aligned with those of a dry container.
- New container types added:
45HC
,20NOR
,40HCNOR
,40RF
,LNR1
,45RH
. - Updated:
40NOR
β now classified as dry instead of reefer. - See list of all supported values here.
π Ocean Route APIs
π οΈ Fixes and improvements
Schedules β routing via Suez or Cape of Good Hope based on actual operations
Weβve aligned schedules routing logic with the one already used for proformas (/itinerary/v2/proformas
), improving accuracy for COGH or Suez passages during the Red Sea crisis.
This means /itinerary/v2/execution
and /v3/routes
(type=schedule
) now reflect the actual operational routing per schedule, instead of relying on static assumptions.
- We determine if vessels are using Suez or COGH based on average operational speed and transit time feasibility.
- This logic updates per schedule, so changes in a carrierβs routing will be visible without affecting unrelated schedules.
- The routing decision is made individually for each schedule, based on that scheduleβs operational data. For example, if a carrier makes a one-off decision to pass via Suez, this will be reflected in that scheduleβs routing β even if the service proforma or other schedules indicate a COGH passage based on their communicated transit times.
/itinerary/v2/proformas
already benefits from this since early 2025 (cf. release note).
Routing logic for ports with smaller draft
We refined our routing logic to improve coverage for ports with shallow draft restrictions.
- A recent change strengthened routing alignment with typical container vessel paths, but it unintentionally made certain ports unreachable. The new adjustment balances both, increasing the likelihood of returning valid routes to ports such as Helsinki that were previously excluded.
- This also benefits
/shipment/v2/report/co2
, which relies on/route/v2/sea
to find a valid route before retrieving emissions. - Example:
/route/v2/sea/ESBIO%3BSEHEL?continuousCoordinates=true&allowIceAreas=false&avoidHRA=false&avoidSeca=false'
Previously: route not found. Now: route returned.
curl --request GET \
--url 'https://api.searoutes.com/route/v2/sea/ESBIO%3BSEHEL?continuousCoordinates=true&allowIceAreas=false&avoidHRA=false&avoidSeca=false' \
--header 'accept: application/json' \
--header 'x-api-key: YOUR API KEY'
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"distance": 2459666,
"mode": "sea",
"departure": 1754670464971,
"arrival": 1754881292971,
"duration": 210828000,
"speed": 42.0,
"areas": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"id": 11130,
"name": "Bay of Biscay",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
-4.0622431822143295,
45.35730136339238
]
}
},
{
"type": "Feature",
"properties": {
"id": 11133,
"name": "Dover Strait",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
1.504635456741771,
51.00363699928965
]
}
},
{
"type": "Feature",
"properties": {
"id": 21119,
"name": "Baltic Sea SECA",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
22.0090457126244,
59.37689920159984
]
}
},
{
"type": "Feature",
"properties": {
"id": 21120,
"name": "North Sea SECA",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
3.9519262988678223,
55.70352264087898
]
}
},
{
"type": "Feature",
"properties": {
"id": 11138,
"name": "Skaw",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
9.296345898943533,
57.997486670380106
]
}
},
{
"type": "Feature",
"properties": {
"id": 11091,
"name": "Oresund",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
12.733783570422341,
55.76919557097896
]
}
}
],
"properties": null
},
"details": [],
"secaIntersection": 1798255,
"hraIntersection": 0,
"speedInKts": 22.678,
"intersectsIceArea": false,
"vessel": {
"imo": 9999999,
"name": "Default vessel",
"length": 150.0,
"width": 20.0,
"mmsi": 999999999,
"maxDraft": 4.2
}
},
"geometry": {
"type": "LineString",
"coordinates": [
[
-3.02149617671967,
43.3230037689209
],
[
-3.0249553755048746,
43.329797630598165
],
[
-3.026451130656348,
43.33310791100946
],
[
-3.0271365084358255,
43.33519923071388
],
[
-3.0278218862153023,
43.3372905504183
],
[
-3.0285072639947797,
43.339381870122715
],
[
-3.029101537851634,
43.34227346473489
],
[
-3.0296047077858654,
43.34596533425482
],
[
-3.0328753949249005,
43.35091492264533
],
[
-3.0389135992687386,
43.35712222990642
],
[
-3.051302328877483,
43.364539664133126
],
[
-3.0700415837511343,
43.37316722532544
],
[
-3.0854758927636574,
43.38716486120805
],
[
-3.0976052559150515,
43.406532571780964
],
[
-3.116162229301769,
43.439497733950105
],
[
-3.141146812923808,
43.48606034771549
],
[
-3.180534191995834,
43.56021616979575
],
[
-3.2343243665178476,
43.66196520019091
],
[
-3.2964395903341406,
43.77742978654137
],
[
-3.3668798634447135,
43.906609928847125
],
[
-3.5232560683199132,
44.1987966178378
],
[
-3.76556820495974,
44.653989853513394
],
[
-3.9196540781183797,
44.96594321572438
],
[
-3.9855136877958337,
45.134656704470764
],
[
-4.051766382916838,
45.30333189073812
],
[
-4.118412163481395,
45.47196877452646
],
[
-4.18546027530806,
45.64056643689033
],
[
-4.2529107183968335,
45.80912487782974
],
[
-4.320773006136989,
45.97764315101281
],
[
-4.389047138528525,
46.14612125643954
],
[
-4.457742906265793,
46.314558219358
],
[
-4.526860309348791,
46.482954039768174
],
[
-4.596409425923781,
46.651307713418404
],
[
-4.666390255990763,
46.8196192403087
],
[
-4.7368131757263825,
46.98788758555969
],
[
-4.807678185130641,
47.156112749171385
],
[
-4.878995969442343,
47.32429366445798
],
[
-4.9507665286614895,
47.492430331419484
],
[
-5.023000868595574,
47.66052165033137
],
[
-5.095698989244596,
47.82856762119363
],
[
-5.168872228989137,
47.99656710995457
],
[
-5.242520587829199,
48.1645201166142
],
[
-5.314777615251023,
48.30807890363743
],
[
-5.385643311254611,
48.42724347102428
],
[
-5.376522472707349,
48.52383342433149
],
[
-5.242861413060183,
48.63485643317284
],
[
-5.069191564667209,
48.71836387222782
],
[
-4.85365890838996,
48.82424842555059
],
[
-4.538373494764113,
48.98034590615949
],
[
-4.291438094599616,
49.10309170599904
],
[
-4.112852707896467,
49.192485825069255
],
[
-3.7285853262936115,
49.384153195744574
],
[
-2.8436612615397663,
49.82506412916522
],
[
-2.3889941873101175,
49.90349425226527
],
[
-1.8951302794081486,
49.98156482913126
],
[
-1.4754748628601069,
50.0531739146663
],
[
-0.9654066350320023,
50.14434503449242
],
[
-0.5495175495810194,
50.21801475777589
],
[
-0.22780760650715792,
50.27418308451674
],
[
0.04633858661909766,
50.32305503284047
],
[
0.3862122513870724,
50.38541838770039
],
[
0.47253568476440444,
50.40243780295372
],
[
0.5067370241478619,
50.408828096042456
],
[
0.5729,
50.4225
],
[
0.6145384466557706,
50.42872527725953
],
[
0.7647726424575273,
50.457597071992794
],
[
0.812156037313929,
50.46474297105633
],
[
0.861,
50.4721
],
[
0.9104,
50.4846
],
[
0.9664804483415,
50.49484618777237
],
[
1.0284861391426847,
50.52225233506476
],
[
1.0500037174906192,
50.534815971428
],
[
1.1389406040322048,
50.581503431802005
],
[
1.2273783338705995,
50.63150002622297
],
[
1.2839039392786953,
50.65843867697325
],
[
1.3558,
50.7072
],
[
1.4552,
50.9118
],
[
1.5143097626982471,
50.95849717205491
],
[
1.6107170389701677,
51.0228913905645
],
[
1.6469448847308519,
51.04578817305556
],
[
1.6546870248447625,
51.08041518760811
],
[
1.6834372671801816,
51.110232184245376
],
[
1.6941278899138013,
51.118621210505154
],
[
1.7101638240345096,
51.133158581671125
],
[
1.7244179876793169,
51.147691377659186
],
[
1.7422356922488973,
51.16613026161963
],
[
1.7894526093595573,
51.1985201413861
],
[
1.8215244775874169,
51.22475042091321
],
[
1.8714140503713281,
51.25598401488469
],
[
1.8984443812388254,
51.27256591366352
],
[
1.9355577868271894,
51.30223766008368
],
[
1.958978381835014,
51.322236739022514
],
[
1.9907136622310588,
51.34255191013756
],
[
2.0326723370809248,
51.36902449425662
],
[
2.072035629979979,
51.40141907163152
],
[
2.1149567697191856,
51.422172322946096
],
[
2.1609172541589032,
51.45032941456674
],
[
2.203459927503279,
51.481923713
],
[
2.23619735798448,
51.51103032987763
],
[
2.273441198826333,
51.53420365781429
],
[
2.3122698839521547,
51.55884319016579
],
[
2.3795996490406544,
51.593068967224085
],
[
2.5833348652140407,
51.74480190473719
],
[
2.6580495569829403,
51.792248698673035
],
[
2.6515454015866595,
51.81887388549658
],
[
2.5887272962814993,
51.840493063186436
],
[
2.575472079950604,
51.902144814969475
],
[
2.6117797525939745,
52.00382914084569
],
[
2.6348809499057264,
52.086326602502645
],
[
2.644775671885859,
52.149637199940344
],
[
2.693162392916586,
52.23943754244824
],
[
2.780041112997907,
52.355727630026365
],
[
2.831237550544839,
52.4250636453304
],
[
2.8467517055573817,
52.44744558836037
],
[
2.949532193612601,
52.56424518187967
],
[
3.2346024252594443,
52.88107104789266
],
[
3.309569130828588,
53.00413829561898
],
[
3.3402586209324068,
53.06210789187758
],
[
3.3814708572520518,
53.06832272405803
],
[
3.5310854462468653,
53.30699172883585
],
[
3.629254647472095,
53.33596554400299
],
[
3.7702471047369737,
53.508076366477944
],
[
4.2469,
53.7263
],
[
4.594806308223497,
53.91746543498297
],
[
4.63619840643407,
54.00043424581659
],
[
4.659102262391027,
54.05364428042278
],
[
4.751660981012868,
54.1469767294989
],
[
4.813552934554735,
54.2091666349866
],
[
4.875631029223911,
54.27132481324458
],
[
4.937897055858826,
54.33345092613735
],
[
5.000351014459483,
54.395544973664926
],
[
5.062994715243548,
54.457606613331336
],
[
5.1258281582110214,
54.5196358451366
],
[
5.188853173161817,
54.58163232216003
],
[
5.252069760095935,
54.64359604440163
],
[
5.315479768599516,
54.705526660450786
],
[
5.379083198672561,
54.767424170307486
],
[
5.442881919892358,
54.82928821800492
],
[
5.506875932258907,
54.8911188035431
],
[
5.571067125545994,
54.952915566331804
],
[
5.635455499753618,
55.01467850637103
],
[
5.700042965058458,
55.07640725837889
],
[
5.764829521460513,
55.13810182235541
],
[
5.829817099746155,
55.19976182825775
],
[
5.8950056999153855,
55.26138727608591
],
[
5.943004206596568,
55.305487903460175
],
[
5.973812619789701,
55.33206371038054
],
[
6.004662421160106,
55.35863174775042
],
[
6.03555361070778,
55.38519201556984
],
[
6.06648635770199,
55.41174447748669
],
[
6.097460662142737,
55.43828913350097
],
[
6.128476694028649,
55.464825947059296
],
[
6.159534453359726,
55.491354918161676
],
[
6.190634110866199,
55.517876010052206
],
[
6.221775666548069,
55.544389222730906
],
[
6.252959291869502,
55.570894519238145
],
[
6.284184986830496,
55.59739189957392
],
[
6.315452923631625,
55.62388132657365
],
[
6.346763102272888,
55.65036280023734
],
[
6.378115695693481,
55.67683628319418
],
[
6.409510703893403,
55.70330177544416
],
[
6.440948300552776,
55.72975923940905
],
[
6.4724284856716,
55.75620867508884
],
[
6.503951433673259,
55.78265004469655
],
[
6.535517144557753,
55.80908334823218
],
[
6.593500000000001,
55.85915
],
[
6.6779,
55.93285
],
[
6.739085106810931,
55.987866090236935
],
[
6.777055320432794,
56.0241982707108
],
[
6.815097152665061,
56.060518748790734
],
[
6.853210603507733,
56.09682752447675
],
[
6.891396093838097,
56.133124521382996
],
[
6.929653623656151,
56.16940973950947
],
[
6.967983616623428,
56.205683101865766
],
[
7.006386072739929,
56.241944608451874
],
[
7.044861418469139,
56.27819418166739
],
[
7.08340965381106,
56.314431821512294
],
[
7.12203120804881,
56.35065744977067
],
[
7.160726081182389,
56.386871066442524
],
[
7.199494705332114,
56.423072592690865
],
[
7.238337080497985,
56.459262028515695
],
[
7.27725364165525,
56.49543929445342
],
[
7.316244388803909,
56.531604390504015
],
[
7.355309759791993,
56.56775723657161
],
[
7.394449754619501,
56.60389783265617
],
[
7.433664814024941,
56.640026098023846
],
[
7.472954938008314,
56.67614203267462
],
[
7.510904812340215,
56.70979416917509
],
[
7.547514437020642,
56.74098250752527
],
[
7.584184947708053,
56.7721600853197
],
[
7.6209163444024455,
56.803326902558375
],
[
7.657708932603583,
56.834482897757916
],
[
7.694562712311466,
56.86562807091832
],
[
7.731477990666633,
56.89676236013743
],
[
7.768454767669084,
56.927885765415255
],
[
7.805493352107078,
56.95899822442776
],
[
7.842593743980615,
56.99009973717493
],
[
7.8797562537326655,
57.02119024090768
],
[
7.91698088136323,
57.052269735626
],
[
7.954267938976898,
57.083338158152515
],
[
7.991617426573669,
57.114395508487235
],
[
8.029029657926515,
57.145441723021335
],
[
8.066504633035436,
57.176476801754816
],
[
8.10404266734875,
57.207500680644166
],
[
8.141643760866458,
57.238513359689385
],
[
8.179308230718984,
57.269514774409
],
[
8.217036076906329,
57.300504924803
],
[
8.265443874494384,
57.326695064957605
],
[
8.32453162348315,
57.348085194872816
],
[
8.383688239838506,
57.36944758382522
],
[
8.442913723560451,
57.390782231814825
],
[
8.502208168487812,
57.4120890285632
],
[
8.561571574620586,
57.43336797407036
],
[
8.621004034362954,
57.45461895777122
],
[
8.680505547714915,
57.47584197966579
],
[
8.740076205625456,
57.49703692890428
],
[
8.799716008094578,
57.51820380548668
],
[
8.859425044595127,
57.539342498280455
],
[
8.919203315127106,
57.56045300728559
],
[
8.979050907666334,
57.581535221088785
],
[
9.038967822212811,
57.60258913969005
],
[
9.098954145224383,
57.623614651397375
],
[
9.159009876701049,
57.64461175621075
],
[
9.219135101561449,
57.665580342161576
],
[
9.279329819805582,
57.686520409249844
],
[
9.339594114791645,
57.70743184523249
],
[
9.399927986519632,
57.72831465010951
],
[
9.4459706903769,
57.74236304059422
],
[
9.477722226363447,
57.7495770166866
],
[
9.509486427131577,
57.75678304604754
],
[
9.541263292681293,
57.76398112867703
],
[
9.573052812177593,
57.77117125381095
],
[
9.604854985620477,
57.77835342144929
],
[
9.636669802053802,
57.785527620832596
],
[
9.668497261477569,
57.792693851960856
],
[
9.700337352814273,
57.799852104079434
],
[
9.732190076063915,
57.80700237718831
],
[
9.764055420027404,
57.81414466053776
],
[
9.795933384704739,
57.82127895412775
],
[
9.827823958774928,
57.828405247213595
],
[
9.859727142237972,
57.83552353979529
],
[
9.891642923650693,
57.84263382113327
],
[
9.923571303013091,
57.849736091227534
],
[
9.955512268759605,
57.856830339343794
],
[
9.987465820890236,
57.86391656548204
],
[
10.019431947716663,
57.870994758913376
],
[
10.051410649238887,
57.878064919637794
],
[
10.116425,
57.90375
],
[
10.214475,
57.948049999999995
],
[
10.342346832125703,
57.93477049228401
],
[
10.500040496377105,
57.86391147685204
],
[
10.598068279035267,
57.819149483059824
],
[
10.636430180100186,
57.80048451090738
],
[
10.682170455592162,
57.78687533423725
],
[
10.735289105511196,
57.778321953049456
],
[
10.797161322853034,
57.75840894684166
],
[
10.867787107617678,
57.72713631561389
],
[
10.909775,
57.70715
],
[
10.923125,
57.69845
],
[
10.967563020055458,
57.67673997798482
],
[
11.04308906016637,
57.642019933954465
],
[
11.096739060166371,
57.61286993395447
],
[
11.128513020055456,
57.58928997798482
],
[
11.177840625079062,
57.567870142596746
],
[
11.244721875237186,
57.54861042779022
],
[
11.309871875237187,
57.513360427790225
],
[
11.373290625079061,
57.462120142596746
],
[
11.415368376444732,
57.420154386245926
],
[
11.4361051293342,
57.38746315873779
],
[
11.460361282803207,
57.351719397365116
],
[
11.488136836851755,
57.31292310212793
],
[
11.510822176595742,
57.283075005842214
],
[
11.528417302035162,
57.262175108507975
],
[
11.54617512053657,
57.237075974030375
],
[
11.564095632099962,
57.20777760240943
],
[
11.58448088788165,
57.17730264843163
],
[
11.607330887881638,
57.14565111209697
],
[
11.626991915911223,
57.11606900794723
],
[
11.643463971970407,
57.08855633598242
],
[
11.668679237526225,
57.03973105428167
],
[
11.702637712578674,
56.969593162845
],
[
11.733362712578675,
56.918343162845
],
[
11.760854237526225,
56.885981054281665
],
[
11.795769026309477,
56.84087561964223
],
[
11.83810707892843,
56.78302685892671
],
[
11.90750712911951,
56.63847608711869
],
[
12.003969176882716,
56.407223304218185
],
[
12.067675150573239,
56.285747684575945
],
[
12.09862505019108,
56.274049228191984
],
[
12.1479,
56.255525
],
[
12.2155,
56.230175
],
[
12.2837,
56.20485
],
[
12.352500000000001,
56.17955
],
[
12.41077160679299,
56.15987476422553
],
[
12.458514820378968,
56.14582429267658
],
[
12.49036403050026,
56.13299136982883
],
[
12.51429684048517,
56.11556830860898
],
[
12.542905366919813,
56.10143116407125
],
[
12.57937702572471,
56.08556814704198
],
[
12.631615046254694,
56.05870478017968
],
[
12.643394789750392,
56.053235900856656
],
[
12.644914402200568,
56.04509320361453
],
[
12.6515462067591,
56.03567640465825
],
[
12.658988082167212,
56.034352278816954
],
[
12.6945652961731,
56.0339393615723
]
]
}
}
],
"properties": {
"distance": 2459666,
"mode": "sea",
"departure": 1754670464971,
"arrival": 1754881292971,
"duration": 210828000,
"speed": 42.0,
"areas": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"id": 11130,
"name": "Bay of Biscay",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
-4.0622431822143295,
45.35730136339238
]
}
},
{
"type": "Feature",
"properties": {
"id": 11133,
"name": "Dover Strait",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
1.504635456741771,
51.00363699928965
]
}
},
{
"type": "Feature",
"properties": {
"id": 21119,
"name": "Baltic Sea SECA",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
22.0090457126244,
59.37689920159984
]
}
},
{
"type": "Feature",
"properties": {
"id": 21120,
"name": "North Sea SECA",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
3.9519262988678223,
55.70352264087898
]
}
},
{
"type": "Feature",
"properties": {
"id": 11138,
"name": "Skaw",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
9.296345898943533,
57.997486670380106
]
}
},
{
"type": "Feature",
"properties": {
"id": 11091,
"name": "Oresund",
"alternatives": []
},
"geometry": {
"type": "Point",
"coordinates": [
12.733783570422341,
55.76919557097896
]
}
}
],
"properties": null
},
"details": [],
"secaIntersection": 1798255,
"hraIntersection": 0,
"speedInKts": 22.678,
"intersectsIceArea": false,
"vessel": {
"imo": 9999999,
"name": "Default vessel",
"length": 150.0,
"width": 20.0,
"mmsi": 999999999,
"maxDraft": 4.2
}
}
}
Trace endpoint β accuracy improvements for edge cases
We refined /vessel/v2/trace
cleaning logic to better handle tricky AIS patterns, such as repeated back-and-forth pings, which could previously lead to distorted routes.
- Now returns accurate historical traces even in complex cases.
- Example: vessel between China and the Philippines now shows correct routing after refinement.
/vessel/v2/trace?imo=9425514&departureDateTime=2025-05-04T15%3A00%3A00Z&arrivalDateTime=2025-07-12T16%3A00%3A00Z
You just read our Product Update π
We'd love to hear what you think about these updates. Send us your feedback at [email protected]!