API Reference
Vessels info by IMO or MMSI number.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| imo | string | Optional | - | IMO number |
| mmsi | string | Optional | - | MMSI number |
| Property | Type | Description | |
|---|---|---|---|
imo | string | International Maritime Organization number, a unique 7-digit identifier assigned to the vessel. | pattern: ^[0-9]{7}$ |
info | object | Additional detailed information about the vessel. | |
└─beam | string | Beam (width) of the vessel expressed in meters, including unit. | pattern: ^[0-9]+\s?m$ |
└─length | string | Length of the vessel expressed in meters, including unit. | pattern: ^[0-9]+\s?m$ |
curl "https://api.infoplaza.dev/v1/vessel/info? \
api_key=$INFOPLAZA_API_KEY"{
"imo": "9279410",
"info": {
"beam": "12 m",
"length": "82 m",
"country": "Norway",
"callsign": "LATH7",
"category": "Tankers",
"builtYear": "2004",
"deadweight": "3480",
"countryCode": "NO",
"categoryType": "CO2 Tanker"
},
"mmsi": "257206000",
"name": "GERDA"
}└─country | string | Name of the country where the vessel is registered. |
└─callsign | string | Radio callsign of the vessel. |
└─category | string | General category of the vessel (e.g., Tankers, Cargo). |
└─builtYear | string | Year the vessel was built, formatted as a four digit year. | pattern: ^[0-9]{4}$ |
└─deadweight | string | Deadweight tonnage of the vessel as a numeric string, representing the carrying capacity. | pattern: ^[0-9]+$ |
└─countryCode | string | ISO 3166-1 alpha-2 country code for the vessel's registration country. | pattern: ^[A-Z]{2}$ |
└─categoryType | string | Specific type within the vessel's category (e.g., CO2 Tanker). |
mmsi | string | Maritime Mobile Service Identity number, a unique 9-digit identifier for the vessel. | pattern: ^[0-9]{9}$ |
name | string | Name of the vessel. |