Vessel Enrichment API

Access classification, ownership, and management data for vessels worldwide. The vessel enrichment API provides classification records and technical specifications, along with ownership details from maritime registries.

What is Vessel Enrichment Data?

Vessel enrichment data supplements basic AIS tracking with detailed vessel records from classification societies and registries. This includes hull specifications, machinery details, certification status, and corporate ownership chains. These records are essential for due diligence, compliance screening, fleet management, and vessel vetting processes.

Coverage: Classification and ownership records are sourced from maritime registries and updated periodically. Coverage includes vessels with an IMO number registered with major classification societies.

Use Cases

Maritime Due Diligence

Verify vessel specifications, ownership structures, and classification status before chartering or purchasing vessels.

Fleet Compliance

Monitor classification status and certificate validity across your fleet. Track survey schedules and conditions of class.

Risk Assessment

Evaluate vessel condition through classification records, survey history, and technical specifications for underwriting or vetting.

Vessel Vetting

Screen vessels against operational requirements using hull details, machinery specifications, and management records.

Available Endpoints

GET /vessel/{id}/classification

Get Classification Data

Get classification, technical specs, and certification data for a vessel. The {id} parameter accepts either MMSI or IMO number.

Parameters:

id (path) - Vessel identifier (MMSI or IMO number)
filter.idType (query) - Identifier type: mmsi or imo (required)

Response includes:

IMO number, vessel name, and flag state
Classification status and main class notation
Vessel type and purpose codes
Class entry date
Owner name, manager name, and DOC holder
Dimensions (LOA, breadth, draught)
Tonnage (gross tonnage, deadweight)
Machinery details and hull information
Yard/builder information
Certificates list, surveys list, and conditions of class

GET /vessel/{id}/ownership

Get Ownership Details

Get registered ownership, ship manager, and DOC company details for a vessel. The {id} parameter accepts either MMSI or IMO number.

Parameters:

id (path) - Vessel identifier (MMSI or IMO number)
filter.idType (query) - Identifier type: mmsi or imo (required)

Response includes:

Registered owner (name, address)
Ship manager (name, address)
DOC company (name, address)

Code Examples

Get Vessel Classification (cURL)

curl -X GET "https://api.vesselapi.com/v1/vessel/9074729/classification?filter.idType=imo" \
     -H "Authorization: Bearer YOUR_API_KEY"

Get Classification Data (Python)

import requests

response = requests.get(
    "https://api.vesselapi.com/v1/vessel/9074729/classification",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"filter.idType": "imo"}
)

data = response.json()
vessel = data["classification"]
print(f"Vessel: {vessel['identification']['vesselName']}")
print(f"Class: {vessel['classification']['mainClass']}")
print(f"Owner: {vessel['owner']['ownerName']}")

Get Classification Data (JavaScript)

const response = await fetch(
  "https://api.vesselapi.com/v1/vessel/9074729/classification?" +
  new URLSearchParams({ "filter.idType": "imo" }),
  {
    headers: { "Authorization": "Bearer YOUR_API_KEY" }
  }
);

const data = await response.json();
const vessel = data.classification;
console.log(`Vessel: ${vessel.identification.vesselName}, Class: ${vessel.classification.mainClass}`);

Response Fields

Classification Data (/vessel/{id}/classification)

Response structure: The classification response is nested under classification, with fields grouped into sub-objects: identification, classification, owner, dimensions, hull, machinery, and yard.

Field	Description	Example
identification
imoNumber	IMO identification number	9074729
vesselName	Registered vessel name	EVER GIVEN
flagName	Flag state name	Panama
classStatusString	Current classification status	In Class
typeFormatted	Vessel type description	Container Ship
purposes[]	Array of vessel purpose objects, each with `purpose`, `description`, and `isMainPurpose` fields	[{"purpose": "General Cargo", "isMainPurpose": true}]
classification
mainClass	Main classification society	DNV
classNotationString	Full class notation string	+1A1
classEntryDate	Date vessel entered class	2018-05-15
owner
ownerName	Registered owner name	Evergreen Marine Corp
managerName	Technical manager name	Evergreen Marine Corp
docHolderName	DOC holder company name	Evergreen Marine Corp
dimensions
lengthOverall	Length overall in meters	400.0
bm	Breadth moulded in meters	58.8
draught	Maximum draught in meters	16.0
grossTon69	Gross tonnage (1969 convention)	220940
dwt	Deadweight tonnage	199629
certificates[]	Array of vessel certificates	(array)
surveys[]	Array of survey records	(array)
conditions[]	Array of conditions of class	(array)

Ownership Data (/vessel/{id}/ownership)

Field	Description	Example
registered_owner	Registered owner name	Evergreen Marine Corp
registered_owner_address	Registered owner address	Taipei, Taiwan
ship_manager	Ship manager name	Evergreen Marine Corp
ship_manager_address	Ship manager address	Taipei, Taiwan
doc_company	DOC company name	Evergreen Marine Corp
doc_company_address	DOC company address	Taipei, Taiwan

Ready to Enrich Your Vessel Data?

Try these endpoints interactively in the API Explorer, complete with live examples and response previews.

Open API Explorer Get Your API Key