---
title: "MasterData"
method: GET
path: "/masterdata"
tags: ["Credit methods"]
---

# MasterData

`GET /masterdata`

## Request

- Base URL: `https://api.vesselfinder.com`
- URL: `https://api.vesselfinder.com/masterdata`
- Auth: API key in query parameter `userkey`

Returns vessel particulars (registry, ownership, classification society, dimensions, tonnage) for one or more IMO numbers.

## Query parameters

- `format` 'json' | 'xml'
- `errormode` 409
- `imo` string, required

## Response `200`

Master data records.

- union
  - object[]
    - `MASTERDATA` MasterData, required: Vessel particulars from registry sources.
      - `IMO` integer: IMO number.
      - `NAME` string: Vessel name.
      - `FLAG` string: Flag code. See [Flag codes](https://api.vesselfinder.com/docs/ref-flags.html).
      - `TYPE` string: Vessel type (text, e.g. `Container Ship`).
      - `BUILT` integer: Year built.
      - `BUILDER` string: Shipyard.
      - `OWNER` string: Registered owner.
      - `MANAGER` string: Manager.
      - `CLASS` string: Classification society.
      - `LENGTH` number: Length overall
      - `BEAM` number: Beam
      - `MAXDRAUGHT` number: Maximum draught
      - `GT` integer: Gross tonnage.
      - `NT` integer: Net tonnage.
      - `DWT` integer: Deadweight, metric tonnes.
      - `TEU` integer: Container capacity
      - `CRUDE` integer: Crude oil capacity
      - `GAS` integer: Gas capacity
  - Error: Returned with HTTP 200 (default error mode) when parameters are invalid, the account is expired or blocked, or credits are insufficient. In XML: `<error>ERROR DESCRIPTION</error>`.
    - `error` string, required

## Other responses

- `409`: Error, returned only when `errormode=409` is set.

---

[API](https://skmtc.dev/vesselfinder/apis/vesselfinder-api.md) - [All operations](https://skmtc.dev/vesselfinder/apis/vesselfinder-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vesselfinder/apis/vesselfinder-api/revisions/da7c595e3467?raw)