PortCalls

Description

PORTCALLS method allows you to query arrival and departure information for a specific port, vessel or fleet of vessels. AIS dataset is available for all events and Voyage dataset is available for requested ship arrivals in a selected port.

Data Content Credits
PortCall Port, country, date/time and type of the event (arrival/departure) 2
AIS Coordinates, course, speed, heading, current draught, destination, ETA and static vessel data 1
Voyage Last port/country and time of departure 1

URL format

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&param1=value1&param2=value2....

Parameters

Parameter Required Type Default Description
userkey yes text - Your personal API key
format no text json Response format json or xml
extradata no text - Additional datasets ais
limit no integer - Maximum number of returned records
interval yes integer unlimited The maximum age of the returned events (in minutes)
event no text - Filter data by event type. Possible values are arrival or departure
fromdate no datetime unlimited Portcalls between fromdate and todate (YYYY-MM-DD HH:MM:SS)
todate no datetime unlimited Portcalls between fromdate and todate (YYYY-MM-DD HH:MM:SS)
imo yes* list of integers - List of IMO numbers (comma separated)
mmsi yes* list of integers - List of MMSI numbers (comma separated)
locode yes* text - Unique ID of the requested port

*Note: At least one IMO number or MMSI number or Port LOCODE is required. Any combination between several IMO and MMSI numbers is possible but combination betwenn IMO/MMSI numbers and Port LOCODE is not allowed.

Examples (JSON format)

Portcalls for selected ship (IMO 9175717)

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&interval=14400&imo=9175717

[  
    {  
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"TRYPO",
            "EVENT":"DEPARTURE",
            "TIMESTAMP":"2017-08-06 15:37:22 UTC",
            "PORT":"Yilport",
            "COUNTRY":"Turkey"
        }
    },
    {  
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"TRAMB",
            "EVENT":"ARRIVAL",
            "TIMESTAMP":"2017-08-06 20:57:34 UTC",
            "PORT":"Ambarli",
            "COUNTRY":"Turkey"
        }
    },
    {  
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"TRAMB",
            "EVENT":"DEPARTURE",
            "TIMESTAMP":"2017-08-07 00:05:59 UTC",
            "PORT":"Ambarli",
            "COUNTRY":"Turkey"
        }
    },
    {  
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"ITGIT",
            "EVENT":"ARRIVAL",
            "TIMESTAMP":"2017-08-12 02:57:05 UTC",
            "PORT":"Gioia Tauro",
            "COUNTRY":"Italy"
        }
    },
    {  
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"ITGIT",
            "EVENT":"DEPARTURE",
            "TIMESTAMP":"2017-08-12 14:06:31 UTC",
            "PORT":"Gioia Tauro",
            "COUNTRY":"Italy"
        }
    }
]

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&interval=7200&extradata=ais&imo=9175717

[  
    {  
        "AIS":{  
            "MMSI":304491000,
            "TIMESTAMP":"2017-08-12 02:57:05 UTC",
            "LATITUDE":38.44518,
            "LONGITUDE":15.88136,
            "COURSE":96.7,
            "SPEED":7.4,
            "HEADING":91,
            "IMO":9175717,
            "NAME":"MARENO",
            "CALLSIGN":"V2BC5",
            "TYPE":70,
            "A":133,
            "B":20,
            "C":14,
            "D":11,
            "DRAUGHT":8.8,
            "DESTINATION":"GIOIA TAURO",
            "ETA_AIS":"08-12 03:00",
            "ETA":"2017-08-12 03:00:00",
            "SRC":"TER"
        },
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"ITGIT",
            "EVENT":"ARRIVAL",
            "TIMESTAMP":"2017-08-12 02:57:05 UTC",
            "PORT":"Gioia Tauro",
            "COUNTRY":"Italy"
        }
    },
    {  
        "AIS":{  
            "MMSI":304491000,
            "TIMESTAMP":"2017-08-12 14:06:31 UTC",
            "LATITUDE":38.44421,
            "LONGITUDE":15.88018,
            "COURSE":239.6,
            "SPEED":6.7,
            "HEADING":240,
            "IMO":9175717,
            "NAME":"MARENO",
            "CALLSIGN":"V2BC5",
            "TYPE":70,
            "A":133,
            "B":20,
            "C":14,
            "D":11,
            "DRAUGHT":9.9,
            "DESTINATION":"TRIESTE",
            "ETA_AIS":"08-14 15:00",
            "ETA":"2017-08-14 15:00:00",
            "SRC":"TER"
        },
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"ITGIT",
            "EVENT":"DEPARTURE",
            "TIMESTAMP":"2017-08-12 14:06:31 UTC",
            "PORT":"Gioia Tauro",
            "COUNTRY":"Italy"
        }
    }
]

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&fromdate=2017-08-01 00:00:00&todate=2017-08-05 23:59:59&limit=2&imo=9175717

[  
    {  
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"TRAMB",
            "EVENT":"DEPARTURE",
            "TIMESTAMP":"2017-08-07 00:05:59 UTC",
            "PORT":"Ambarli",
            "COUNTRY":"Turkey"
        }
    },
    {  
        "PORTCALL":{  
            "MMSI":304491000,
            "IMO":9175717,
            "LOCODE":"TRAMB",
            "EVENT":"ARRIVAL",
            "TIMESTAMP":"2017-08-06 20:57:34 UTC",
            "PORT":"Ambarli",
            "COUNTRY":"Turkey"
        }
    }
]

Portcalls for selected port (BGVAR - Varna/Bulgaria)

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&interval=1440&locode=BGVAR

[  
    {  
        "PORTCALL":{  
            "MMSI":636013076,
            "IMO":9419084,
            "LOCODE":"BGVAR",
            "EVENT":"DEPARTURE",
            "TIMESTAMP":"2017-08-17 12:09:44 UTC",
            "PORT":"Varna",
            "COUNTRY":"Bulgaria"
        }
    },
    {  
        "PORTCALL":{  
            "MMSI":271000086,
            "IMO":7726213,
            "LOCODE":"BGVAR",
            "EVENT":"DEPARTURE",
            "TIMESTAMP":"2017-08-17 12:41:52 UTC",
            "PORT":"Varna",
            "COUNTRY":"Bulgaria"
        }
    },
    {  
        "PORTCALL":{  
            "MMSI":457303000,
            "IMO":8107000,
            "LOCODE":"BGVAR",
            "EVENT":"ARRIVAL",
            "TIMESTAMP":"2017-08-17 12:51:16 UTC",
            "PORT":"Varna",
            "COUNTRY":"Bulgaria"
        }
    },
]

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&interval=720&extradata=voyage&locode=BGVAR

[  
    {  
        "PORTCALL":{  
            "MMSI":207401000,
            "IMO":0,
            "LOCODE":"BGVAR",
            "EVENT":"ARRIVAL",
            "TIMESTAMP":"2017-08-18 02:40:32 UTC",
            "PORT":"Varna",
            "COUNTRY":"Bulgaria"
        },
        "VOYAGE":{  
            "LOCODE":"BGBAL",
            "DEPARTURE":"2017-08-18 00:24:40 UTC",
            "LASTPORT":"Balchik",
            "LASTCOUNTRY":"Bulgaria"
        }
    }
]

Examples (XML format)

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&interval=14400&format=xml&imo=9175717

<VESSELS>
    <VESSEL>
        <PORTCALL MMSI="304491000" IMO="9175717" LOCODE="TRYPO" EVENT="DEPARTURE" TIMESTAMP="2017-08-06 15:37:22 UTC" PORT="Yilport" COUNTRY="Turkey"/>
    </VESSEL>
    <VESSEL>
        <PORTCALL MMSI="304491000" IMO="9175717" LOCODE="TRAMB" EVENT="ARRIVAL" TIMESTAMP="2017-08-06 20:57:34 UTC" PORT="Ambarli" COUNTRY="Turkey"/>
    </VESSEL>
    <VESSEL>
        <PORTCALL MMSI="304491000" IMO="9175717" LOCODE="TRAMB" EVENT="DEPARTURE" TIMESTAMP="2017-08-07 00:05:59 UTC" PORT="Ambarli" COUNTRY="Turkey"/>
    </VESSEL>
    <VESSEL>
        <PORTCALL MMSI="304491000" IMO="9175717" LOCODE="ITGIT" EVENT="ARRIVAL" TIMESTAMP="2017-08-12 02:57:05 UTC" PORT="Gioia Tauro" COUNTRY="Italy"/>
    </VESSEL>
    <VESSEL>
        <PORTCALL MMSI="304491000" IMO="9175717" LOCODE="ITGIT" EVENT="DEPARTURE" TIMESTAMP="2017-08-12 14:06:31 UTC" PORT="Gioia Tauro" COUNTRY="Italy"/>
    </VESSEL>
</VESSELS>

https://api.vesselfinder.com/portcalls?userkey=AABBCCDD&interval=720&extradata=voyage&format=xml&locode=BGVAR

<VESSELS>
    <VESSEL>
        <PORTCALL MMSI="207401000" IMO="0" LOCODE="BGVAR" EVENT="ARRIVAL" TIMESTAMP="2017-08-18 02:40:32 UTC" PORT="Varna" COUNTRY="Bulgaria"/>
        <VOYAGE LOCODE="BGBAL" DEPARTURE="2017-08-18 00:24:40 UTC" LASTPORT="Balchik" LASTCOUNTRY="Bulgaria"/>
    </VESSEL>
</VESSELS>