ETAs

How to find estimated time of arrival to destination port in payload

Within the JSON payload, the ETA, or estimated time to arrival, to the destination port will be listed as an individual milestone within the list of milestones.

The Vessel arrived at destination port milestone represents the ETA of the vessel to the destination port when planned is set to true. This same milestone will then represent the ATA (actual time of arrival) when planned is set to false.

See below for an example of this estimated milestone:

{
  "id": "removed",
  "version": "removed",
  "timestamp": "2026-01-01T07:00:00.000-04:00",
  "location": {
    "name": "Savannah",
    "city": "Savannah",
    "state": "Georgia",
    "country": "United States",
    "unlocode": "USSAV",
    "splc_cd": null,
    "firms_cd": null,
    "bic_cd": null,
    "smdg_cd": null,
    "facility_code": null,
    "facility": null,
    "geolocation": {
      "latitude": 32.11042,
      "longitude": -81.12264
    },
    "timezone": "America/New_York",
    "lookup_params": {
      "locationLookupName": "SAVANNAH, GA",
      "locode": "USSAV",
      "providerCode": "HLCU",
      "facilityType": "port_terminal"
    },
    "lookup_method": "CACHE",
    "lookup_result": null
  },
  "description": "Vessel arrived at destination port",
  "raw_description": "Vessel arrival",
  "journey_event": {
    "journey_type": "TRANSPORT",
    "event_classifier": "EST",
    "event_type": "ARRI",
    "transport_mode": "VESSEL",
    "facility_type": "POTE"
  },
  "shipment_location": {
    "type_code": "POD"
  },
  "vessel": "removed",
  "vessel_imo": "removed",
  "vessel_mmsi": "removed",
  "voyage": "removed",
  "transport_key": null,
  "planned": true,
  "mode": "Vessel",
  "transport_type": null,
  "source": "carrier"
}

The ETA milestone can come from more than one source, shown by the source property. A carrier source is the carrier's own estimated arrival. A vizion source is a Vizion Predictive ETA: Vizion's own estimated arrival, generated from vessel schedule and voyage data, independent of the carrier's. A shipment may carry a Vizion Predictive ETA alongside or in place of the carrier's, it can be present even when the carrier has not published an ETA, and it will not appear on every shipment. See Vizion Predictive ETAs.


Did this page help you?