Changelog

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

[v5 – 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).

[v4 – 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.

[v3 – 2025‑08‑26]

Added

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

[v2 – 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.

[v1 – 2025‑03‑19]

• Initial Release