MarineTraffic · Schema

MarineTraffic Vessel Master Data

Vessel master record (static AIS data + MarineTraffic vessel database) as returned by the VD02 vesselmasterdata endpoint.

AISMaritimeVessel TrackingShippingPortsVoyage ForecastingGeospatialKpler

Properties

Name Type Description
MMSI stringinteger Maritime Mobile Service Identity.
IMO stringintegernull IMO number.
SHIP_ID stringinteger MarineTraffic internal vessel ID.
SHIPNAME string Current vessel name.
CALLSIGN stringnull Radio call sign.
FLAG stringnull ISO 3166-1 alpha-2 flag state.
TYPE_NAME stringnull Human-readable ship type.
SHIPTYPE stringinteger AIS ship type code.
BUILT stringintegernull Year of build.
DEAD_WEIGHT numberstringnull Deadweight tonnage (metric tons).
GROSS_TONNAGE numberstringnull Gross tonnage.
LENGTH numberstringnull Overall length in metres.
BREADTH numberstringnull Beam (width) in metres.
DEPTH numberstringnull Moulded depth in metres.
DRAUGHT numberstringnull Maximum design draught in metres.
OWNER stringnull Beneficial owner / registered owner.
MANAGER stringnull Ship manager.
BUILDER stringnull Shipyard / builder.
CLASS_SOCIETY stringnull Classification society.
STATUS stringnull Operational status (e.g. "Active", "Scrapped").
HOME_PORT stringnull Home port (from AIS or registry).
LAST_KNOWN_PORT stringnull Last port visited.
LAST_SIGNAL stringnull UTC timestamp of the last received AIS signal.
View JSON Schema on GitHub

JSON Schema

marine-traffic-vessel-master-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/marine-traffic/main/json-schema/marine-traffic-vessel-master-schema.json",
  "title": "MarineTraffic Vessel Master Data",
  "description": "Vessel master record (static AIS data + MarineTraffic vessel database) as returned by the VD02 vesselmasterdata endpoint.",
  "type": "object",
  "properties": {
    "MMSI": {"type":["string","integer"],"description":"Maritime Mobile Service Identity."},
    "IMO": {"type":["string","integer","null"],"description":"IMO number."},
    "SHIP_ID": {"type":["string","integer"],"description":"MarineTraffic internal vessel ID."},
    "SHIPNAME": {"type":"string","description":"Current vessel name."},
    "CALLSIGN": {"type":["string","null"],"description":"Radio call sign."},
    "FLAG": {"type":["string","null"],"description":"ISO 3166-1 alpha-2 flag state."},
    "TYPE_NAME": {"type":["string","null"],"description":"Human-readable ship type."},
    "SHIPTYPE": {"type":["string","integer"],"description":"AIS ship type code."},
    "BUILT": {"type":["string","integer","null"],"description":"Year of build."},
    "DEAD_WEIGHT": {"type":["number","string","null"],"description":"Deadweight tonnage (metric tons)."},
    "GROSS_TONNAGE": {"type":["number","string","null"],"description":"Gross tonnage."},
    "LENGTH": {"type":["number","string","null"],"description":"Overall length in metres."},
    "BREADTH": {"type":["number","string","null"],"description":"Beam (width) in metres."},
    "DEPTH": {"type":["number","string","null"],"description":"Moulded depth in metres."},
    "DRAUGHT": {"type":["number","string","null"],"description":"Maximum design draught in metres."},
    "OWNER": {"type":["string","null"],"description":"Beneficial owner / registered owner."},
    "MANAGER": {"type":["string","null"],"description":"Ship manager."},
    "BUILDER": {"type":["string","null"],"description":"Shipyard / builder."},
    "CLASS_SOCIETY": {"type":["string","null"],"description":"Classification society."},
    "STATUS": {"type":["string","null"],"description":"Operational status (e.g. \"Active\", \"Scrapped\")."},
    "HOME_PORT": {"type":["string","null"],"description":"Home port (from AIS or registry)."},
    "LAST_KNOWN_PORT": {"type":["string","null"],"description":"Last port visited."},
    "LAST_SIGNAL": {"type":["string","null"],"format":"date-time","description":"UTC timestamp of the last received AIS signal."}
  },
  "required":["MMSI","SHIP_ID","SHIPNAME"],
  "additionalProperties": true
}