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>