Ship ETA Data API

Sep 7, 2021 | Vessel Future Schedules Data

Ship ETA data API

In this article, we will take a look at the details of the Ship ETA data API by Datalastic. This API focuses on the departure and arrival times of ships along with current location data. This makes the API a one-in-all data source to track maritime and port traffic in real-time. The data is particularly useful to,

  • Analyze and optimize maritime operations, 
  • Determine the safest and most time and cost-effective routes for cargo and passenger transportation,
  • Run analysis on fuel consumption,
  • Track port traffic all around the world,
  • Create algorithms based on the changes on arrival/departure times in real-time and historically, and much more.

Estimated time of arrival for a vessel may be updated many times throughout the course of the route. This can be because of the changes in weather, maritime traffic or sometimes accidents, like the Suez Canal incident in March 2021. As a result, to be able to have correct ship ETA data, you need an API that updates as new information comes along. Luckily, Datalastic Ship ETA Data API focuses on this important data as well, so keep reading!

Important Note: Our real-time ship tracking API has 3 different endpoints (as seen below in the Developer Information section) for 3 different formats. Please read to avoid confusion and choose the best option for you.

  1. Basic: very fast, lite version of live ship tracker API with basic data included. (For example:{YOUR_API_KEY}&mmsi=566093000). An Average API request reponse takes around 0.007 seconds.
  2. Pro: additionally includes many other useful data like estimated and actual time of departure, current draft, standardized destination/port names to what the basic endpoint has but may be a bit slowlier than the basic one. (For example:{YOUR_API_KEY}&mmsi=566093000).
  3. Bulk: allows pulling up to 100 ships at one time via a single API call. (For Example:{YOUR_API_KEY}&mmsi=566093000)

If you are looking to track ship ETA, Pro endpoint is the one for you. Accordingly, we will focus on the Pro endpoint data in this article.

So, Datalastic API – what are the advantages? Port information in ship tracking data can often include information that every captain fills in himself/herself. This would mean that every captain may use a –still correct- but different format for destination. For example, if a ship is on its course to Rotterdam Port, we may see the arrival port data as “NLROT” (Un/locode of the port), “ROTT” or “ROTTERDAM”, meaning that the data in an API response would also come in a non-standardized format. This may cause confusion since one port in the response can be in un/locode format when another can be in a different one; or the same port can be shown differently for different ships. Datalastic Ship ETA Data API standardizes this information, so every single ship’s data in the response has a uniform format for your convenience. This is crucial especially when analyzing a high number of ships at the same data or analyzing these historically. 

Ship ETA Data API – Developer Information

Basic, Pro and Bulk versions have different vessel values parameters which facilitates you an easy way to find the ship you are tracking. If you are interested in the other two than Pro (Basic and Bulk), feel free to check out API Reference page for more information. 

It is possible to filter all 3 endpoints data by 3 different values:

  • uuid – Vessel UUID:{YOUR_API_KEY}&uuid=b8625b67-7142-cfd1-7b85-595cebfe4191
  • mmsi – Vessel MMSI:{YOUR_API_KEY}&mmsi=566093000
  • imo – Vessel IMO:{YOUR_API_KEY}&imo=9525338

However, you can use your API key with any of the endpoints above without having to obtain a different one for each. It’s a “one API key-fits-all” size!

A standard response of the Pro endpoint looks like this:


    “data”: {

        “uuid”: “b8625b67-7142-cfd1-7b85-595cebfe4191”,

        “name”: “MAERSK CHENNAI”,

        “mmsi”: “566093000”,

        “imo”: “9525338”,

        “eni”: null,

        “country_iso”: “SG”,

        “type”: “Cargo – Hazard A (Major)”,

        “type_specific”: “Container Ship”,

        “lat”: 6.303473,

        “lon”: 3.201678,

        “current draught”:13.1

        “speed”: 0,

        “course”: 326,

        “navigational_status”: “Under Way using engine” 

        “heading”: 226,

        “destination”: “TGLFW>NGAPP”,

        “dest_port”: “LOME”

        “dest_port_unlocode”: “TGLFW”

        “last_position_epoch”: 1620484020,

        “last_position_UTC”: “2021-05-08T14:27:00Z”

        “atd_epoch”: 1621469820


        “eta_epoch”: 1622980800





Let’s first focus on the “destination” details and ETA part of the response to take a closer look at this standardized format we mentioned above, with explanations for each parameter based on the example:

  • “destination”: “TGLFW>NGAPP”,: Un/locode of the “departure port>arrival port”. Un/locodes are uniquely assigned for each port and globally accepted.
  • “dest_port”: “LOME”: shows the destination port’s name (not codes).
  • “dest_port_unlocode”: “TGLFW”: Un/locode of the destination port alone.
  • “last_position_epoch”: 1620484020,: Last recorded position of the ship in Epoch format. Frequently updated.
  • “last_position_UTC”: “2021-05-08T14:27:00Z”: Last recorded position in UTC.
  • “atd_epoch”: 1621469820: Actual Time of Departure in Epoch format
  • “atd_UTC”:”2021-05-20T00:17:00Z“: Actual Time of Dearture in UTC
  • “eta_epoch”: 1622980800: Estimated Time of Arrival in Epoch format
  • “eta_UTC”:”2021-06-06T12:00:00Z”: Estimated Time or Arrival in UTC

This is the standard format you will see for each ship in the response. The other ship details in the full parameter above are also standardized.

Please note that every parameter is not available as a filter. The filters are limited to “&uuid=”, “&mmsi=” and “&imo=” only.

If you have more questions about the meaning of the parameters, feel free to contact us anytime. We’d be happy to talk in more detail and provide examples if needed ☺

Get Your API Key for Datalastic Ship ETA API!

You can get your API key and set it up in under 5 minutes easily. Start getting ship ETA data at very cost-friendly options for your business. Cancel or upgrade your plan at any time.

The automatically generated API key will be sent to your email address on the spot. No further authorization is required, the key is ready to use right away! 

Click the button below and join now!


3 Easy Steps
to get your Vessel AIS API

Choose your Maritime API Subscription Plan

Choose your plan

Choose the Vessel AIS API plan that
fits your needs


Proceed to the payment and
subscribe to the chosen Vessel AIS API plan

Subscribe to Datalastic
Check your email to receive your maritime API key

Get your API Key by email

You will recieve your API key by email.
Go ahead and start using it!

Instantly Get your Maritime API key

Choose your plan

Choose the API plan that fits to your needs


Proceed to the payment and subscribe to the chosen plan

Get your API by email

You will recieve your API key by email. Go ahead and start using it!

Read Other Maritime Articles 

How Classification Societies Influence Dry Dock Scheduling?

How Classification Societies Influence Dry Dock Scheduling?

In the maritime world, the safety and efficiency of a vessel are paramount. This is where the roles of classification societies and dry dock schedules become pivotal. Both elements are essential cogs in the maritime machinery, ensuring that ships not only meet global...

Dry Dock Schedules Data: Discover Dates & Details

Dry Dock Schedules Data: Discover Dates & Details

In the world of maritime operations, staying ahead in the game means keeping your vessel in top-notch condition. But how can you ensure this without a solid grasp of your ship's maintenance schedule? This is where the importance of understanding ship dry dock...

Dry Dock Dates Data:Navigating Fleet Maintenance

Dry Dock Dates Data:Navigating Fleet Maintenance

In the complex and ever-evolving maritime industry, staying ahead in maintenance schedules is not just about compliance; it's a critical component of operational efficiency and safety. Datalastic's Dry Dock Dates Vessels API emerges as a beacon of innovation, offering...

How To Get Data about Vessel Engines Performance?

How To Get Data about Vessel Engines Performance?

  In the vast and ever-evolving maritime industry, the performance of a vessel's engine stands as a pivotal factor that directly influences its speed, efficiency, and overall operational capacity. Understanding this dynamic is crucial for ship operators, owners,...

Ship Owners Types: A Comprehensive Overview

Ship Owners Types: A Comprehensive Overview

Ship owners play a pivotal role in the maritime industry. They range from individuals to expansive corporations, responsible for hiring crews and managing the ship's journey. In this article we will unveiling how to uncover data about these owners and pinpoint the...