Add a new ship

Time	Status	User Agent
Retrieving recent requests…

class

Ship design class.

ship_type

string

enum

required

country

length between 2 and 2

Country of registration, in 2-letter ISO 3166-1 alpha-2 format.

build_year

1900 to 2026

Build year of the ship.

shipyard

length ≤ 256

Shipyard where the ship was built.

dwt

0 to 1000000

Deadweight tonnage in metric tons.

teu

0 to 30000

Twenty-foot Equivalent Unit capacity. Required for container ships.

0 to 1000000

Gross tonnage in metric tons. Required for cruise and RoRo ships.

cbm

0 to 1000000

Cubic meters of cargo space. Required for gas tankers.

ceu

0 to 10000

Car Equivalent Unit capacity.

beam

number

required

0 to 200

Beam in meters.

loa

number

required

0 to 500

Length overall in meters.

mcr

0 to 200000

Maximum continuous rating in kW.

min_allowed_mcr_percentage

number

0 to 1

Defaults to 0.1

Minimum allowed load as a fraction of MCR (0-1). Predictions with power output below this threshold will be set to null. For example, 0.1 means 10% of MCR.

max_allowed_mcr_percentage

number

0 to 1

Defaults to 0.9

Maximum allowed load as a fraction of MCR (0-1). Predictions with power output above this threshold will be set to null. For example, 0.9 means 90% of MCR.

min_rpm

0 to 1000

Minimum speed of the propeller in RPM.

max_rpm

0 to 1000

Maximum speed of the propeller in RPM.

propeller_type

PropellerType | null

Defaults to FPP

has_shaft_generator

boolean

Defaults to false

Whether the ship has a shaft generator installed.

has_rotor_sail

boolean

Defaults to false

Whether the ship has a rotor sail installed.

has_air_lubrication

boolean

Defaults to false

Whether the ship has an air lubrication system installed.

other_propulsion_tech

length ≤ 255

Free-text description of other propulsion technology installed on the ship.

ballast_draft

0 to 50

Draft in meters when the ship is empty. The opposite of summer draft.

laden_draft

0 to 50

Draft in meters when the ship is fully loaded with cargo. The opposite of lightship draft.

created_at

Date and time when the ship was created.

name

string

required

length ≤ 300

Name of the ship.

imo_number

integer

required

1 to 9999999

International Maritime Organization (IMO) number. Must be unique.

owner

length ≤ 128

Name of the fleet ID who owns this ship. Leave out to determine automatically.

shop_test_data

array | null

List of shop test data for the ship.

sea_trial_data

array | null

List of sea trial data points for the ship.

sea_trial_draft

Draft in meters applicable to all sea trial data points.

201Successful Response

422Validation Error