Port Calls API
Arrivals and departures, with timestamps, for any vessel or any port
By port
Give a port's UN/LOCODE and a time window, and receive every arrival and departure at that port. Each event is a separate record with its type and time in UTC. Response in JSON.
By vessel
Give one or more IMO or MMSI numbers and a time window, and receive the port calls of those vessels. Each record is one arrival or one departure, with its time and the port's name, country and UN/LOCODE. Response in JSON.
Available Datasets
- PortCall - port name, country, LOCODE, arrival and departure times
- AIS - MMSI, IMO, name, callsign, AIS type, dimensions, coordinates, course, speed, heading, navigational status, draught, destination and its UN/LOCODE, ETA (as reported by the vessel), ECA zone flag
- Voyage - last port of call (name, country, UN/LOCODE) and time of departure
Keeping costs down
- Port calls are discrete events, not tracks - each record is one arrival or one departure, not the route between them.
- If you poll regularly, request only the events newer than the last one you processed rather than repeating the same date range. On a busy port this is the difference between a few records per call and several hundred.
- Anchorage events can be included, excluded, or returned on their own.
Credits
This is a credit-based service. Buy a package of credits and spend them across any credit-based service:
Vessels,
PortCalls,
Expected Arrivals,
MasterData,
Distance.
You are charged per record returned, not per request. There is no rate limit, your only constraint is your credit balance.
A request that returns no records costs nothing, and filtering parameters let you cap what a single request can return.
Credits are valid for 12 months, and every purchase resets the expiry across your entire balance. An account that keeps topping up does not lose credits.
Credit costs:
- PortCall dataset: 2 credits per record
- AIS dataset: 1 credit per record
- Voyage dataset: 1 credit per record
Credit Prices
- 5,000 credits: 175 EUR
- 10,000 credits: 330 EUR
- 20,000 credits: 625 EUR
- 50,000 credits: 1470 EUR
All credits are valid for 12 months after purchase.
Prices do not include VAT.
Sample use cases
1) You need to analyze the ports visited by 5 vessels over the past three months. The API returns 60 port call records and charges you 120 credits (60 records × 2 credits each).
2) You need just the arrival events of all vessels that visited the port of Rotterdam over the last six months. The API returns the arrival records for 1,000 vessels and charges you 2,000 credits (1,000 records x 2 credits each).
Full parameters, response fields and sample requests are in the API documentation.
For pricing, data samples or a trial, contact us.