MasterData

Description

MASTERDATA method allows you to query vessel particulars for one or more vessels in JSON or XML format.

Dataset	Content	Credits
Master	IMO, name, flag, type, year of build, builder, owner / manager, classification society, dimensions, maximum draught, gross tonnage, net tonnage, deadweight, TEU, crude capacity	3

URL format

https://api.vesselfinder.com/masterdata?userkey=AABBCCDD&param1=value1&param2=value2....

Parameters

Parameter	Required	Type	Default	Description
userkey	yes	text	-	Your personal API key
format	no	text	json	Response format json or xml
imo	yes	list of integers	-	List of IMO numbers (comma separated)

Example (JSON format)

https://api.vesselfinder.com/masterdata?userkey=AABBCCDD&imo=9175717

[  
    {  
        "MASTERDATA":{  
            "IMO":9175717,
            "NAME":"MARENO",
            "FLAG":"ZZ",
            "TYPE":"Container Ship",
            "BUILT":2000,
            "BUILDER":"SAINT JOHN SB",
            "OWNER":"MARENO GMBH & CO KG",
            "MANAGER":"WORDEN GMBH & CO KG",
            "LENGTH":153.6,
            "BEAM":25.4,
            "MAXDRAUGHT":13.51,
            "GT":12827,
            "NT":7258,
            "DWT":17705,
            "TEU":1174,
            "CRUDE":0
        }
    }
]

Example (XML format)

https://api.vesselfinder.com/masterdata?userkey=AABBCCDD&format=xml&imo=9175717

<VESSELS>
  <VESSEL>
    <MASTERDATA IMO="9175717" NAME="MARENO" FLAG="ZZ" TYPE="Container Ship" BUILT="2000" BUILDER="SAINT JOHN SB" OWNER="MARENO GMBH & CO KG" MANAGER="WORDEN GMBH & CO KG" LENGTH="153.6" BEAM="25.4" MAXDRAUGHT="13.51" GT="12827" NT="7258" DWT="17705" TEU="1174" CRUDE="0"/>
  </VESSEL>
</VESSELS>