Changelog

All notable changes to the Tanker Historical Ship Status API are documented on this page.

[v6 – 2026‑05‑21]

Added

• New field vessel_main_status – the vessel's operational status derived from polygon events.
  • Possible values: at_shipyard, at_berth, at_anchorage, at_canal, at_port, at_sea
• New filter vessel_main_statuses – filter by one or more main statuses (array).
• New filter is_in_blackout – filter vessels currently in blackout (boolean).
• New filter destinations – filter by destination port or country. Accepts location IDs, names, or UN/LOCODE (array).
• New Trade Flow fields providing voyage-level information:
  • trade_flow_voyage_id, trade_flow_type (laden / ballast), trade_flow_cabotage
  • trade_flow_commodity_name, trade_flow_commodity_group, trade_flow_intake_mt, trade_flow_intake_cbm
  • Departure: trade_flow_departure_from, trade_flow_departure_to, trade_flow_departure_port_id, trade_flow_departure_port_name, trade_flow_departure_country_id, trade_flow_departure_country_name, trade_flow_departure_zone_id, trade_flow_departure_zone_name
  • Arrival: trade_flow_arrival_from, trade_flow_arrival_to, trade_flow_arrival_port_id, trade_flow_arrival_port_name, trade_flow_arrival_country_id, trade_flow_arrival_country_name, trade_flow_arrival_zone_id, trade_flow_arrival_zone_name
• New filter commodities – filter by commodity names (array).
• New filter voyage_type – filter by laden or ballast.
• New filter include_cabotage – include cabotage voyages (boolean).

[v5 – 2025‑11‑12]

Added

• New field ais_destination_id to expose the numeric ID of the current destination.
• New fields anchorage_event_id, berth_event_id, canal_event_id, port_event_id, shipyard_event_id, and zone_event_id to expose the numeric ID of each polygon event.

[v4 – 2025‑08‑26]

Added

• New field ais_raw_destination
  • Type: string
  • Description: The raw destination string received by the AIS signal.
  • Example: "SGP"

[v3 – 2025‑07‑21]

Added

• New filter query parameter vessel_ids (array of unique vessel IDs) to filter results by internal vessel identifiers.
• New field vessel_id to expose the unique vessel identifier.

[v2 – 2025‑07‑01]

Added

• New filtering query parameters:
  • Vessel characteristics (vessel_built_from, vessel_built_to, vessel_beam_from, vessel_beam_to, vessel_loa_from, vessel_loa_to, vessel_draft_from, vessel_draft_to, vessel_dwt_from, vessel_dwt_to, vessel_teu_from, vessel_teu_to)
  • AIS characteristics (ais_date_from, ais_date_to, ais_heading_from, ais_heading_to, ais_draft_from, ais_draft_to, ais_speed_from, ais_speed_to)
  • Snapshot information (snapshot_hours, snapshot_time_from, snapshot_time_to)
  • Polygon‑level filtering (polygon_ids, updated_after)
• Expanded the response model with polygon‑event details (zone, port, canal, anchorage, berth, shipyard, blackout).
• Increased maximum page_size to 10,000.
• Updated date‑time examples to include UTC offsets.
• Added validation for snapshot_hours (only 0,6,12,18 allowed).

Changed

• Renamed time filter parameters: time_from → snapshot_time_from, time_to → snapshot_time_to.

[v1 – 2024‑03‑19]

• Initial Release