Skip to main content
Trace the ownership chain of any vessel from registered owner through to ultimate beneficial owner. The UBO graph resolves corporate structures and cross-references ownership entities against sanctions lists, showing where a vessel sits in the broader network.

​
GET /api/v1/ubo/vessel/{imo}

Requires API key.
Returns the full beneficial ownership graph for a vessel, including the sanctions network — all entities in the ownership chain that have sanctions matches. Parameters
NameTypeRequiredDescription
imostring✓7-digit IMO number (path param)
Response 
{
  "vessel": {
    "imo_number": "9622629",
    "name": "MV Meridian"
  },
  "graph": {
    "nodes": [
      { "id": "registered_owner:ABC Shipping Ltd", "type": "company", "role": "registered_owner" },
      { "id": "operator:XYZ Management", "type": "company", "role": "operator" },
      { "id": "ubo:John Doe", "type": "individual", "role": "beneficial_owner" }
    ],
    "edges": [
      { "from": "registered_owner:ABC Shipping Ltd", "to": "operator:XYZ Management", "relation": "managed_by" },
      { "from": "operator:XYZ Management", "to": "ubo:John Doe", "relation": "owned_by" }
    ]
  },
  "sanctions_network": {
    "matches": [
      {
        "entity": "XYZ Management",
        "list_source": "OFAC SDN",
        "match_type": "exact",
        "sanctioned_entity": "XYZ Management LLC"
      }
    ],
    "flagged_count": 1
  },
  "tier": "pro"
}
Example 
curl -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/ubo/vessel/9622629

​
GET /api/v1/ubo/vessels

Requires API key.
Batch lookup of vessels with sanctions-flagged ownership. Returns a summary for each vessel indicating whether any entity in its ownership chain has a sanctions match. Response 
{
  "vessels": [
    {
      "imo_number": "9622629",
      "name": "MV Meridian",
      "has_sanctions_match": true,
      "match_count": 1
    }
  ]
}
Example 
curl -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/ubo/vessels