5 Types of Data Endpoints in Datalastic Maritime API

Mar 5, 2021 | Maritime API

5 types of Datalastic Data Endpoints

Datalastic provides multiple maritime data endpoints that allow you to retrieve the data from the Datalastic database and further use it for data analysis, applications, software, platforms, and so on.

 

Datalastic Endpoints:

  1. Vessel Information API
  2. Maritime Port information API
  3. Ship Real-time tracking API
  4. Zone vessel traffic API
  5. Ship Historical Data API

Vessel Information API Endpoint

With this endpoint, users can access data about ships such as vessel MMSI, IMO, country name, call-sign, ship type and subtype, sip gross tonnage, deadweight, TEU, length, breadth, year built, and home port, liquid gas on board, quantity.

Datalastic has more than 306 vessel types and subtypes which allows users to understand the vessels with great precision.

See a typical vessel information data output on the right.

See here your typical request where “MMSI”, “IMO” and “UUID” are numbers of a vessel:

https://api.datalastic.com/api/v0/vessel_info?api-key={YOUR_API_KEY}&uuid=b8625b67-7142-cfd1-7b85-595cebfe4191
https://api.datalastic.com/api/v0/vessel_info?api-key={YOUR_API_KEY}&mmsi=566093000
https://api.datalastic.com/api/v0/vessel_info?api-key={YOUR_API_KEY}&imo=9525338

Here is a typical response to the data requested:

{
    "data": {
        "uuid": "b8625b67-7142-cfd1-7b85-595cebfe4191",
        "name": "MAERSK CHENNAI",
        "name_ais": "MAERSK CHENNAI",
        "mmsi": "566093000",
        "imo": "9525338",
        "eni": null,
        "country_iso": "SG",
        "country_name": "Singapore",
        "callsign": "9V9409",
        "type": "Cargo - Hazard A (Major)",
        "type_specific": "Container Ship",
        "gross_tonnage": 50869,
        "deadweight": 61614,
        "teu": "4500",
        "liquid_gas": null,
        "length": 249.12,
        "breadth": 37.4,
        "year_built": "2011",
        "is_navaid": false,
        "home_port": null
    },
    "meta": {
        "duration": 0.008994512
        "endpoint": "/api/v0/vessel_info",
        "success": true
    }
}
vessel information api endpoint

Maritime Port information API Endpoint

See all the data about marine ports and view information that is essential to you. With Maritime Port information endpoint you will access data about port name, country ISO, country name of that port, unlocode, port type, location (longitude and latitude) and 2 area levels as in the example. Your typical request:
https://api.datalastic.com/api/v0/port_find?api-key={YOUR_API_KEY}&name=rotterdam
Here is a typical response to the marine ports data requested:
{
 {
    "data": [
        {
            "uuid": "37a8ac5b-d126-d7ce-9aca-7b8249c2efd2",
            "port_name": "ROTTERDAM",
            "country_iso": "NL",
            "country_name": "Netherlands",
            "unlocode": "NLRTM",
            "port_type": "Port",
            "lat": 	51.94331,
            "lon": 4.141812,
            "area_lvl1": "UK Coast & Atlantic",
            "area_lvl2": "Rotterdam Area"
        },
    ],
    "meta": {
        "duration": 0.060431033,
        "endpoint": "/api/v0/port_find",
        "success": true
    }
}
marine ports information api endpoint

Ship Real-time tracking API Endpoint

With this endpoint, customers can view the current position of the vessels, UUID, Name of the vessel, IMO, MMSI numbers, country ISO, type and subtype of the vessel, current longitude and latitude, speed, course, heading, navigational status, destination and the timestamp of the last position reported.

Your typical request:

https://api.datalastic.com/api/v0/vessel?api-key={YOUR_API_KEY}&uuid=b8625b67-7142-cfd1-7b85-595cebfe4191
https://api.datalastic.com/api/v0/vessel?api-key={YOUR_API_KEY}&mmsi=566093000
https://api.datalastic.com/api/v0/vessel?api-key={YOUR_API_KEY}&imo=9525338

Here is a typical response to the marine ports data requested:

{
    "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": 35.88855,
        "lon": -5.499166,
        "speed": 0.1,
        "course": 214,
        "navigational_status": "Under Way using engine"" 
        "heading": 44,
        "destination": "MAPTM>ATSEA",
        "last_position_epoch": 1614900540,
        "last_position_UTC":"2021-03-04T23:29:00Z"
    },
    "meta": {
        "duration": 0.009448773,
        "endpoint": "/api/v0/vessel",
        "success": true
    }
}
Real Time Ship data API endpoint

Zone vessel traffic API Endpoint

In case that you don’t need to monitor a specific vessel but you are rather interested in an area to be supervised, then you have a zone vessel traffic monitoring option. Just define the location you need and the radius around and start seeing all vessel traffic coming to that area.

Your typical request:

https://api.datalastic.com/api/v0/vessel_inradius?api-key={YOUR_API_KEY}&lat=29.15915&lon=-89.25454&radius=3
https://api.datalastic.com/api/v0/vessel_inradius?api-key={YOUR_API_KEY}&mmsi=566093000&radius=5

Here is a typical response to the marine ports data requested:

As you see we found 14 ships in a radius of 3 in a certain location defined by longitude and latitude. For this article, we are going to put a screenshot only of 1 vessel instead of 14 to make it more compact.

{
    "data": {
        "point": {
            "lat": 29.15915,
            "lon": -89.25454,
            "radius": 3
        },
        "total": 14,
        "vessels": [
            {
                "uuid": "1964bb6e-ec2e-5fe3-911b-69a2ca339b6c",
                "name": "LAYLA RENEE",
                "mmsi": "367430840",
                "imo": "null",
                "eni": null,
                "country_iso": "US",
                "type": "Tug",
                "type_specific": "Tug",
                "lat": 29.15903,
                "lon": -89.24783,
                "speed": 0,
                "course": 291,
                "heading": 291,
                "destination": "HEAD OFF",
                "last_position_epoch": 1615046400,
                "last_position_UTC": "2021-03-06T16:00:00Z",
                "distance": 0.351893014470194
            }
Zone Marine traffic API endpoint

Excel Static Databases

In case you need only a static database with Vessel or Ports information, sometimes getting an excel or CSV file also pays off, the upside of this option is that it is a one-time payment and you access data in a very familiar format: Excel, downside tho is that this vessel data with time become outdated and you would need to redownload the file manually. Using API the vessel and Port data is always maintained up to date with the latest standards. 

You can see a full static Excel database offering on our website

Full Vessel Static database in Excel to download Example

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...