Changelog

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

[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, vessel_service_ids, vessel_service_region_ids)
  • 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