Overview

Enhanced Vessel Data (EVD) is a set of additional data that provides further  information for a variety of commercial vessels within the Vessels API. This information relates to the following categories:

  • Capacity
  • Design
  • Dimensions
  • History
  • Propulsions
  • Registration
  • Vessel and Trading Type

These fields are updated on a regular basis and exist within two sets: Default and Extended.

  • Default EVD fields are available within both the Standard and Premium Vessels APIs.
  • Extended EVD Fields are available within the Premium Vessels API.

Enhanced Vessel Data Query Parameters

Simply include embed=enhanced_data  as a query parameter within a Vessels API call to return EVD fields:
GET https://ais.spire.com/vessels?embed=enhanced_data 

For applicable vessels, EVD will be appended to the vessel record. (If we don't have a value for the field, null is returned.)

An example follows:

{
   paging: { ... }
   data: [
        {
            // ...
            "_embedded": {
                "enhanced_data": {
                    "_embedded": {
                        "history": {
                            "built_year": 2011,
                            "commercial_owner": "Jacob E.",
                            "dead_year": null,
                            "hull_number": "PC760-20",
                            "ship_builder": "Dalian No. 1",
                            "name_date": "2008-01-23T00:00:00+00:00"
                        },
                        "capacity": {
                            "dwt": 75618,
                            "gross_tonnage": 43904,
                            "displacement": null,
                            "grain_cubic_capacity": null,
                            "liquid_cubic_98_percent": 83897,
                            "net_tonnage": 21970,
                            "teu": null,
                            "tpcmi": null
                        },
                        "dimensions": {
                            "air_draught": null,
                            "draught": 14.7,
                            "ktm": null,
                            "loa": 228.6
                        },
                        "design": {
                            "coated": 1
                        },
                        "vessel_and_trading_type": {
                            "vessel_type": "Tanker",
                            "subtype": "Petroleum Product Tanker",
                            "trading_category": "In Service",
                            "trading_status": "Existing"
                        },
                        "propulsions": {
                            "engine_designation": "6S60MC",
                            "main_engine_designer": "MAN B&W",
                            "main_engines": 1,
                            "mco": 12240,
                            "mco_unit": "KW",
                            "mcormp": null,
                            "propeller_type": null,
                            "propellers": 1,
                            "propulsion_type": "Motor"
                        },
                        "registration": {
                            "class_1_code": "DNV-GL",
                            "ice_class": null,
                            "ice_classed": false
                        }
                    }
                }
            }            
            // ...
        }
    ]
}


If only interested in one category of EVD, specify the category of interest:
GET https://ais.spire.com/vessels?embed=enhanced_data.capacity

{
   paging: { ... }
   data: [
        {
            // ...
            "_embedded": {
                "enhanced_data": {
                    "_embedded": {
                        "capacity": {
                            "dwt": 75618,
                            "gross_tonnage": 43904,
                            "displacement": null,
                            "grain_cubic_capacity": null,
                            "liquid_cubic_98_percent": 83897,
                            "net_tonnage": 21970,
                            "teu": null,
                            "tpcmi": null
                        }
                    }
                }
            }            
            // ...
        }
    ]
}

Or categories of interest in a comma separated list:
GET https://ais.spire.com/vessels?embed=enhanced_data.capacity,enhanced_data.propulsions 

{
   paging: { ... }
   data: [
        {
            // ...
            "_embedded": {
                "enhanced_data": {
                    "_embedded": {
                        "capacity": {
                            "dwt": 75618,
                            "gross_tonnage": 43904,
                            "displacement": null,
                            "grain_cubic_capacity": null,
                            "liquid_cubic_98_percent": 83897,
                            "net_tonnage": 21970,
                            "teu": null,
                            "tpcmi": null
                        },
                            "propulsions": {
                            "engine_designation": "6S60MC",
                            "main_engine_designer": "MAN B&W",
                            "main_engines": 1,
                            "mco": 12240,
                            "mco_unit": "KW",
                            "mcormp": null,
                            "propeller_type": null,
                            "propellers": 1,
                            "propulsion_type": "Motor"
                        }
                    }
                }
            }            
            // ...
        }
    ]
}

Default EVD Fields

Default EVD fields are available within both the Standard and Premium Vessels APIs:

Capacity

  • dwt: Deadweight; difference between displacement and the empty vessel (lightweight) at any given draught
  • gross_tonnage: Vessel gross tonnage

History

  • built_year : Year vessel was delivered from the shipyard to its owner

Vessel and Trading Type

  • vessel_type : Broad type of vessel
  • subtype : Specific subtype of vessel

Extended EVD Fields

Extended EVD Fields are available within the Premium Vessels API:

Capacity

  • displacement : The amount of water (in tons) displaced by the ship
  • grain_cubic_capacity : Cubic capacity of cargo holds for grain (and other loose dry commodities)
  • liquid_cubic_98_percent : The liquid cubic capacity of the cargo tanks when filled to 98% of capacity
  • net_tonnage : Vessel net tonnage
  • teu : "Twentyfoot Equivalent Unit" (measurement of container carrying capacity)
  • tpcmi : Tons per Centimeter - how many tons are required to increase the draught by 1cm - (useful for trying to estimate the volume of cargo onboard)

Propulsions

  • engine_designation : Engine model
  • main_engine_designer : Engine designer
  • main_engines : Number of engines
  • mco : Maximum continuous output (power)
  • mco_unit : Maximum continuous output (power unit (e.g. KW ))
  • mcormp : Maximum continuous output RPM
  • propeller_type : Propeller type
  • propellers : Number of propellers
  • propulsion_type : Propulsion type code (e.g. Motor , Gas Turbine )

Registration

  • class_1_code : The name of the classification society who inspects the vessel and awards statutory certificates
  • ice_class : Ice class ID
  • ice_classed: Indicates if the vessel ice classed (Yes/No)

History

  • commercial_owner : Vessel commercial owner
  • dead_year : Year vessel was scrapped or destroyed
  • hull_number : Hull number assigned by the shipyard
  • ship_builder : Full name of ship builder
  • name_date : Vessel name date (for history of name changes, etc.)

Design

  • coated : Indicated if the vessel tanks are coated (Yes/No)

Dimensions

  • air_draught : Distance from the waterline to highest point on vessel
  • draught : Distance between the waterline and keel
  • ktm : Distance from the keel to the manifold
  • loa : Length overall

Vessel and Trading Type

  • trading_category : Vessel trading category
  • trading_status : Vessel trading status

Did this answer your question?