Accessing Spire Enhanced Vessels Data (EVD)

How to access the Enhanced Vessels Data in Vessels API as well as sample outputs.

Note: with the launch of Maritime 2.0 graphQL API that replaces the Spire Vessels API, EVD in Vessels API is replaced by Vessel Characteristics in Maritime 2.0

Vessel Characteristics data in Maritime 2.0 is documented here 

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",
                            "mcorpm": 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",
                            "mcorpm": 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 (in cubic meters) 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 ))
  • mcorpm : 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