Changelog

All notable changes to the Liner Current 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).

[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‑06‑26]

Added

• Polygon id filter: polygon_ids.
• Vessel‑build date filters: vessel_built_from and vessel_built_to.
• Vessel‑beam filters: vessel_beam_from and vessel_beam_to.
• Vessel‑loa filters: vessel_loa_from and vessel_loa_to.
• Vessel‑draft filters: vessel_draft_from and vessel_draft_to.
• Vessel‑dwt filters: vessel_dwt_from and vessel_dwt_to.
• Vessel‑TEU filters: vessel_teu_from and vessel_teu_to.
• Service‑id filters: vessel_service_ids and vessel_service_region_ids.
• AIS‑date filters: ais_date_from and ais_date_to.
• AIS‑heading filters: ais_heading_from and ais_heading_to.
• AIS‑draft filters: ais_draft_from and ais_draft_to.
• AIS‑speed filters: ais_speed_from and ais_speed_to.
• Updated updatedAfter parameter name (updated_after) retained.
• New fields vessel_service_name, vessel_service_id.

[v1 – 2025‑03‑19]

• Initial Release