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

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 

Engine types database

Engine types database

Download Ship Engine Database Datalastic Ship Engine Database is the ultimate database that covers all the essential information on vessels, including one of the highly important parts that most databases in the market pass over, engine types. Why is having vessel...

Estimated Time of Arrival Ship Data API

Estimated Time of Arrival Ship Data API

ETA (Estimated time of Arrival) of vessels is a very useful data for Maritime, Logistics, Transportation, Tourism and any other industries that benefit from Maritime Data. Datalastic constantly works on new features release this time based on many customer requests,...

Connecting Ships Data API to Microsoft Power BI for Data Analytics

Connecting Ships Data API to Microsoft Power BI for Data Analytics

There are multiple ways how to make a use of Maritime Data by analyzing it in PowerBI or any other data analytics program. You can choose either uploading a static excel sheet and analyze the current statistics about the vessels and maritime ports or you can yous...

Historical Vessel Tracking Data

Historical Vessel Tracking Data

In this article, we will talk about our Historical Ship Tracking API, possible use cases, types of data the API covers, available API endpoints/filters, and how to subscribe to get started in minutes. We will address to the importance of maritime data and maybe...

Ship Types in Database

Ship Types in Database

Datalastic offers a detailed, extensive vessel information database that covers a very large variety of ship types. We aim to make sure you will find the exact type of vessel information using the database that is available either for one-time download or can or as...

Top 5 Maritime News, Blogs & Magazines

Top 5 Maritime News, Blogs & Magazines

The following list of the best maritime magazines, news, and blog providers is independent and it is selected by Datalastic opinion. Datalastic doesn't own or does not have any formal relationship with any of the mentioned news providers. The following magazines do...