MasterData
Description
The MasterData method returns vessel particulars for one or more vessels.
| 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 and gas capacity | 3 |
URL format
https://api.vesselfinder.com/masterdata?userkey=YOUR_API_KEY¶m=value&…
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) |
Code examples
curl "https://api.vesselfinder.com/masterdata?userkey=YOUR_API_KEY&imo=9175717"
import requests
resp = requests.get(
"https://api.vesselfinder.com/masterdata",
params={"userkey": "YOUR_API_KEY", "imo": "9175717"},
timeout=30,
)
data = resp.json()
if isinstance(data, dict) and "error" in data:
raise RuntimeError(data["error"])
for vessel in data:
md = vessel["MASTERDATA"]
print(md["NAME"], md["TYPE"], md["BUILT"], md["DWT"])
<?php
$query = http_build_query([
'userkey' => 'YOUR_API_KEY',
'imo' => '9175717',
]);
$data = json_decode(file_get_contents("https://api.vesselfinder.com/masterdata?$query"), true);
if (isset($data['error'])) {
throw new Exception($data['error']);
}
foreach ($data as $vessel) {
$md = $vessel['MASTERDATA'];
echo "{$md['NAME']} {$md['TYPE']} {$md['BUILT']} {$md['DWT']}\n";
}
// Node.js 18+ (save as masterdata.mjs)
const params = new URLSearchParams({ userkey: 'YOUR_API_KEY', imo: '9175717' });
const resp = await fetch(`https://api.vesselfinder.com/masterdata?${params}`);
const data = await resp.json();
if (data.error) throw new Error(data.error);
for (const { MASTERDATA: md } of data) {
console.log(md.NAME, md.TYPE, md.BUILT, md.DWT);
}
package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
)
type vessel struct {
MASTERDATA struct {
NAME string
TYPE string
BUILT int
DWT int
}
}
func main() {
q := url.Values{"userkey": {"YOUR_API_KEY"}, "imo": {"9175717"}}
resp, err := http.Get("https://api.vesselfinder.com/masterdata?" + q.Encode())
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
var raw json.RawMessage
if err := json.NewDecoder(resp.Body).Decode(&raw); err != nil {
log.Fatal(err)
}
var apiErr struct{ Error string }
if json.Unmarshal(raw, &apiErr) == nil && apiErr.Error != "" {
log.Fatal(apiErr.Error)
}
var vessels []vessel
if err := json.Unmarshal(raw, &vessels); err != nil {
log.Fatal(err)
}
for _, v := range vessels {
fmt.Println(v.MASTERDATA.NAME, v.MASTERDATA.TYPE, v.MASTERDATA.BUILT, v.MASTERDATA.DWT)
}
}
Examples
Particulars for one vessel
GET https://api.vesselfinder.com/masterdata?userkey=YOUR_API_KEY&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",
"CLASS": "DNV GL",
"LENGTH": 153.6,
"BEAM": 25.4,
"MAXDRAUGHT": 13.51,
"GT": 12827,
"NT": 7258,
"DWT": 17705,
"TEU": 1174,
"CRUDE": 0,
"GAS": 0
}
}
]
<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" CLASS="DNV GL" LENGTH="153.6" BEAM="25.4" MAXDRAUGHT="13.51" GT="12827" NT="7258" DWT="17705" TEU="1174" CRUDE="0" GAS="0"/>
</VESSEL>
</VESSELS>