Port Operations API

Port Calls by Vessel API

Access up to 90 days of port visit history for any vessel worldwide. Track arrivals, departures, and stay duration across 9,000+ global ports.

Start Free Trial View Documentation

5 Credits per Request

port_calls.json

vesselEXCELSIOR

recent_ports:

BarcelonaAug 31

GenovaAug 30

MarseilleAug 28

history90 days

Credits used5 credits

800K+

Vessels

9,000+

Ports

90 Days

History

5 Credits

Per Request

Complete Port Visit Data

Track every port visit with detailed timing and location information.

Visit Timing

Arrival TimeDeparture TimeVisit Duration

Port Details

Port NamePort Code (UNLOCODE)Country

Vessel Identity

IMOMMSIVessel Name

90-Day History

Up to 90 Days HistoryHistorical Voyage TrackingVisit Frequency Patterns

Global Port Coverage

Track vessel visits to major ports and terminals worldwide.

🇸🇬

Singapore

SGSIN

🇳🇱

Rotterdam

NLRTM

🇨🇳

Shanghai

CNSHA

🇩🇪

Hamburg

DEHAM

🇺🇸

Los Angeles

USLAX

🇦🇪

Dubai

AEJEA

🇭🇰

Hong Kong

HKHKG

🇧🇪

Antwerp

BEANR

...and 9,000+ more ports worldwide

Sample API Response

Example response showing recent port calls for a container vessel.

GET /api/vessels_operations/port-calls-by-vessel?imo_or_mmsi=9184419

{
  "detail": {
    "name": "EXCELSIOR",
    "imo": "9184419",
    "mmsi": "247351100",
    "ports": [
      [
        {
          "arrived": "Aug 31, 12:23",
          "departed": "Aug 31, 16:01",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        },
        {
          "arrived": "Aug 30, 05:44",
          "departed": "Aug 30, 18:02",
          "portName": "Genova Italy",
          "portSign": "ITGOA"
        },
        {
          "arrived": "Aug 29, 05:07",
          "departed": "Aug 29, 09:07",
          "portName": "Barcelona Spain",
          "portSign": "ESBCN"
        }
      ]
    ]
  }
}

Use Cases

How maritime organizations use vessel port call data.

Trade Pattern Analysis

Analyze vessel trading patterns and routes to understand commodity flows, identify market trends, and optimize shipping strategies.

Supply Chain Visibility

Track cargo vessel movements across ports to improve supply chain planning, predict delays, and coordinate logistics operations.

Compliance & Due Diligence

Review vessel port history for sanctions compliance, verify trading patterns, and assess operational risk profiles.

Frequently Asked Questions

What data is included in port call history?

Each port call includes arrival time, departure time, port name, port UNLOCODE, and country. You can calculate visit duration and identify patterns from the historical data.

How far back does the port history go?

Port call history includes up to 90 days of activity, making it ideal for historical voyage tracking and trade pattern analysis. For longer historical analysis, consider combining with our Historical Vessel Location API.

Can I search by IMO or MMSI?

Yes, the API accepts either IMO or MMSI number to identify the vessel. Both vessel identifiers will return the same port call history.

How often is port call data updated?

Port call data is updated continuously as vessels arrive at and depart from ports worldwide. Recent port calls are typically available within hours.

What is the rate limit?

The Port Calls by Vessel endpoint has a rate limit of 15 requests per minute.

Related API Endpoints

Explore other maritime data solutions

Port Calls by Port

Find all vessels visiting a specific port.

Vessel Location

Real-time vessel position tracking.

Historical Vessel Data

Historical AIS track data.

Route Planner

Calculate optimal sea routes.

Track Vessel Port History

Access complete port call history for any vessel with our simple REST API.

Start Free Trial

{ "detail": { "name": "EXCELSIOR", "imo": "9184419", "mmsi": "247351100", "ports": [ [ { "arrived": "Aug 31, 12:23", "departed": "Aug 31, 16:01", "portName": "Barcelona Spain", "portSign": "ESBCN" }, { "arrived": "Aug 30, 05:44", "departed": "Aug 30, 18:02", "portName": "Genova Italy", "portSign": "ITGOA" }, { "arrived": "Aug 29, 05:07", "departed": "Aug 29, 09:07", "portName": "Barcelona Spain", "portSign": "ESBCN" } ] ] } }