Add-ons - Ownership

Vessel beneficial owner, operator, and manager

Changed on

Returns beneficial owner chain, operator, technical manager, and commercial manager with country information. Filter by any of these parties, by vessel, or by updated_from.

Credit cost: 1 per record returned. Requires an Add-Ons plan tier.

For a bulk export, POST to /api/v0/report with report_type: ownership. Bulk reports cost 2,000 credits each.

get/api/maritime_reports/ownership

Request

Query parameters

imostring

IMO vessel number.

namestring

Vessel name.

beneficial_ownerstring

Beneficial owner name (partial match).

operatorstring

Operator name.

technical_managerstring

Technical manager name.

commercial_managerstring

Commercial manager name.

updated_fromstring date

Only return records updated on or after this date (yyyy-mm-dd).

Response

Matching ownership records.

Example response

{
  "data": [
    {
      "id": 38914,
      "imo": "9951783",
      "vessel_name": "KARLOVASI",
      "beneficial_owner": "Samos Steamship Co",
      "beneficial_owner_country": "Greece",
      "operator": "Samos Steamship Co",
      "operator_country": "Greece",
      "vessel_type_code": "Bulk",
      "built_year": "2023",
      "dwt_design": 63470,
      "commercial_manager": "Samos Steamship Co",
      "commercial_manager_country": "Greece",
      "modified_at": "2020-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "duration": 0.012,
    "endpoint": "/api/v0/vessel",
    "success": true,
    "next": "00e32b7a-4067-d6b2-8d73-2bdda4fe72bb"
  }
}

Changes

    • warning

      deleted the query request parameter api-key

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status