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 |
https://api.vesselfinder.com/portcalls?userkey=AABBCCDD¶m1=value1¶m2=value2....
| 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 between IMO/MMSI numbers and Port LOCODE is not allowed.
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,
"NAVSTAT":0,
"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",
"ZONE": "Adriatic Sea",
"ECA": false
},
"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,
"NAVSTAT":0,
"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",
"ZONE": "Mediterranean Sea",
"ECA": false
},
"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"
}
}
]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"
}
}
]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>