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 

Access Any Vessel With IMO API

Access Any Vessel With IMO API

As a developer, you understand the importance of reliable and efficient APIs in your projects. Therefore, IMO API, also known as the International Maritime Organization API, is a comprehensive database of global shipping information. It provides access to a wide range...

Maritime API: 10 Popular Questions And Their Answers

Maritime API: 10 Popular Questions And Their Answers

A maritime API, or application programming interface, is a set of protocols and tools that allows developers to build software applications that interact with maritime data. These APIs enable developers to access and integrate maritime data from various sources, such...

How To Use Maritime Port API For PHP

How To Use Maritime Port API For PHP

As a PHP developer, you may be looking for ways to enhance your applications and provide your users with valuable and relevant data. One tool that can help you achieve this is the Datalastic Maritime Port data API for PHP developers. This API provides access to...

How To Optimize Your Shipping Routes For vessels?

How To Optimize Your Shipping Routes For vessels?

The maritime industry plays a crucial role in the global economy, facilitating the transportation of goods by working on optimizing the shipping routes for vessels across international borders. In fact, managing shipping routes can be a complex and costly endeavor. In...

Unleashing The Power Of The Vessel API In Java

Unleashing The Power Of The Vessel API In Java

If you're a Java developer looking to integrate marine logistics functionality into your projects, then the Vessel API is an excellent option to consider. In this article, we'll take a look at why Java is a good choice for working with the Vessel API As well as, the...

Historical Vessel Location API for Java

Historical Vessel Location API for Java

Historical vessel location API is a Java-based application programming interface (API) that enables developers to access and retrieve historical data for a specific location. Furthermore, the API utilizes various sources of data, such as weather stations and satellite...