ShipFinder
    • Global Maritime Data API Documentation
    • 1 AIS Dataset
      • 1.1 Vessel Position
        • 1.1.1 Single Vessel Position
        • 1.1.2 Multi-vessel Position
        • 1.1.3 Fleet Position
      • 1.2 Vessel Search
        GET
      • 1.3 Vessels Nearby
        GET
      • 1.4 Vessels in Zone
        GET
      • 1.5 Vessel Flag Information
        GET
    • 2 Voyage Dataset
      • 2.1 Port Information
        GET
      • 2.2 Currently Berthed Vessels
        GET
      • 2.3 Currently Anchored Vessels
        GET
      • 2.4 Inbound / Expected Arrivals
        GET
    • 3 History Dataset
      • 3.1 Vessel History Track
        GET
      • 3.2 Ship-to-Ship (STS) Events
        GET
      • 3.3 Vessel Port Call History
        GET
      • 3.4 Vessel Port Call Records at Specific Port
        GET
      • 3.5 Vessel Current Port Call
        GET
      • 3.6 Port Calls Records for Port
        GET
    • 4 Prediction Dataset
      • 4.1 Point-to-Point Route Planning
        GET
      • 4.2 Port-to-Port Route Planning
        GET
      • 4.3 ETA Query
        GET
    • 5 Meteorology Dataset
      • 5.1 Global Tropical Cyclone
        • 5.1.1 Global Tropical Cyclones List
        • 5.1.2 Tropical Cyclone Details by Point
      • 5.2 Global Port Tide Predictions
        • 5.2.1 Request parameters for Global Tide Gauge Stations List
        • 5.2.2 Query Single Tide Gauge Station Details
      • 5.3 Global Marine Weather
        GET
    • 6 China Region Coastline Warning Dataset
      • 6.1 China Region Navigational Warnings
        GET
    • 7 Event Dataset
      • 7.1 Monitored Fleet Management
        • 7.1.1 Create Fleet
        • 7.1.2 Update Fleet Information
        • 7.1.3 Query Fleet
        • 7.1.4 Delete Fleet
        • 7.1.5 Add Vessels to Fleet
        • 7.1.6 Batch Update Vessels in Fleet
        • 7.1.7 Remove Vessels from Fleet
      • 7.2 Geofence Monitoring Push
        • 7.2.1 Geofence Creation
        • 7.2.2 Geofence Update
        • 7.2.3 Geofence Query
        • 7.2.4 Geofence Deletion
        • 7.2.5 Geofence Monitoring Push
      • 7.3 Vessel Speed Alert Push
        • 7.3.1 Add Vessel Speed Alert Subscription
        • 7.3.2 Delete Vessel Speed Alert Subscription
        • 7.3.3 Query Vessel Speed Alert Subscription List
        • 7.3.4 Vessel Speed Anomaly Push
      • 7.4 Real-time Vessel Position Push
      • 7.5 Arrival/Departure Event Push
      • 7.6 Vessel Dynamic ETA Push
      • 7.7 Vessel AIS Signal Loss Event Push
      • 7.8 Vessel STS Event Push
    • Appendix
      • Vessel Type Comparison Table
      • Service Return Code
      • Sea Area Reference Table
      • Navigation Status Comparison Table
      • Deviation Node List
      • Aids to Navigation (AtoN) Type Table

    Global Maritime Data API Documentation

    Official ShipFinder API documentation covering AIS, voyage, history, prediction, meteorology, and event datasets for real-time vessel tracking and maritime intelligence integration.

    Welcome to ShipFinder API#

    ShipFinder API provides a unified gateway to the world’s most comprehensive maritime data. Whether you are building a real-time fleet monitoring dashboard, conducting historical trade analysis, or integrating predictive intelligence into your logistics platform, our APIs deliver the accuracy, speed, and coverage you need.
    This documentation is your complete reference for every endpoint, parameter, and response model. Use it to explore available datasets, test queries, and seamlessly embed maritime intelligence into your applications.

    What You Can Build#

    Live Fleet Tracking – Monitor vessel positions, movements, and status worldwide with sub-second latency.
    Port & Terminal Awareness – Retrieve real-time berth and anchorage data, expected arrivals, and historical port call records.
    Predictive Analytics – Compute optimal point-to-point routes, port-to-port voyages, and accurate ETAs powered by machine learning.
    Safety & Compliance Monitoring – Access global cyclone tracks, tide predictions, marine weather, and regional navigational warnings (including China coastline alerts).
    Event-Driven Automation – Subscribe to push events for vessel arrivals, speed alerts, geofence breaches, AIS signal loss, STS operations, and dynamic ETA changes.
    Historical Investigations – Replay vessel tracks, analyze ship-to-ship meetings, and audit port call histories at scale.

    API Dataset Overview#

    Our API is organized into seven core datasets. Each dataset contains multiple endpoints designed to answer specific maritime questions.

    1. AIS Dataset – Real-Time Vessel Positioning#

    Access the global AIS feed to locate, identify, and filter vessels.
    EndpointDescription
    Vessel PositionRetrieve the latest known position for a specific vessel (IMO, MMSI, or name).
    Vessel SearchSearch for vessels by name, call sign, MMSI, or IMO.
    Vessels NearbyFind all vessels within a defined radius of a coordinate.
    Vessels in ZoneList all vessels currently inside a custom geofence polygon.
    Vessel Flag InformationGet registration details, flag state, and vessel identity records.

    2. Voyage Dataset – Port & Voyage Intelligence#

    Bridge the gap between vessel movements and port operations.
    EndpointDescription
    Port InformationLook up port details, UN/LOCODE, coordinates, and time zone.
    Currently Berthed VesselsList all vessels currently docked at a port.
    Currently Anchored VesselsList all vessels at anchor within a port’s anchorage areas.
    Inbound / Expected ArrivalsRetrieve upcoming arrivals with predicted ETA and last reported position.

    3. History Dataset – Replay & Analyze Past Activities#

    Deep-dive into historical vessel behaviour and port usage.
    EndpointDescription
    Vessel History TrackFetch a vessel’s position history for a selected time window.
    Ship-to-Ship (STS) EventsDiscover historical rendezvous and cargo transfer operations.
    Vessel Port Call HistoryGet a timeline of all port calls made by a vessel.
    Vessel Port Call Records at Specific PortView detailed call logs when a vessel visited a particular port.
    Vessel Current Port CallRetrieve information about a vessel’s ongoing port stay.
    Port Calls Records for PortList all recent arrivals and departures for any given port.

    4. Prediction Dataset – Route & ETA Intelligence#

    Calculate voyages and arrivals before they happen.
    EndpointDescription
    Point-to-Point Route PlanningGenerate the optimal sea route between two coordinates.
    Port-to-Port Route PlanningPlan a complete voyage including pilot stations, traffic lanes, and standard port rotation.
    ETA QueryPredict arrival time at a destination based on current position and voyage parameters.

    5. Meteorology Dataset – Environmental Intelligence#

    Integrate weather and ocean conditions into your operational decisions.
    EndpointDescription
    Global Tropical CycloneRetrieve active cyclone tracks, wind radii, and forecast cones.
    Global Port Tide PredictionsGet tide height forecasts for thousands of ports worldwide.
    Global Marine WeatherAccess wind, wave, current, and visibility data at any coordinate.

    6. China Region Coastline Warning Dataset#

    Specialized warnings for maritime safety in Chinese waters.
    EndpointDescription
    China Region Navigational WarningsRetrieve official navigational alerts, hazards, and safety broadcasts for the China coastline.

    7. Event Dataset – Push-Based Maritime Streams#

    Build reactive, event-driven applications with real-time push notifications.
    EndpointDescription
    Monitored Fleet ManagementCreate and manage custom vessel watchlists.
    Geofence Monitoring PushReceive alerts when vessels enter or exit defined zones.
    Vessel Speed Alert PushGet notified when a vessel exceeds or drops below a speed threshold.
    Real-time Vessel Position PushStream continuous position updates for selected vessels.
    Arrival/Departure Event PushReceive instant push messages for port arrivals and departures.
    Vessel Dynamic ETA PushMonitor ETA changes in real time as voyage conditions evolve.
    Vessel AIS Signal Loss Event PushDetect and alert when a vessel stops transmitting AIS.
    Vessel STS Event PushGet live alerts for ship-to-ship meetings as they occur.

    Getting Started#

    1.
    Authentication – All API requests require an API key. Sign up on the ShipFinder portal to obtain your credentials.
    2.
    Base URL – https://open.shipfinder.com/?utm\_source=shipfinder
    3.
    Response Format – All endpoints return JSON.
    Refer to the individual endpoint pages for detailed parameter descriptions, request examples, and response schemas. If you have questions, our support team is available at shipfinder@elaneglobal.com
    Happy building with ShipFinder – the maritime world, one request away.
    Next
    1.1 Vessel Position
    Built with