Vizion Predictive ETAs

A Vizion Predictive ETA is Vizion's own estimated arrival, generated from vessel schedule and voyage data rather than reported by the carrier or a terminal. It is an independent estimate of the destination arrival, and it can be present even on shipments where the carrier has not published an ETA. It is delivered in the update payload as a standard milestone with a source of vizion.

Vizion Predictive ETAs currently apply to the destination port arrival only.

How it appears in the payload

A Vizion Predictive ETA is the Vessel arrived at destination port milestone with planned set to true and source set to vizion. It sits in the milestones array alongside the other milestones for the shipment.

{
  "timestamp": "2026-01-01T07:00:00.000-04:00",
  "location": {
    "name": "Savannah",
    "city": "Savannah",
    "state": "Georgia",
    "country": "United States",
    "unlocode": "USSAV",
    "geolocation": {
      "latitude": 32.11042,
      "longitude": -81.12264
    },
    "timezone": "America/New_York"
  },
  "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",
  "voyage": null,
  "planned": true,
  "mode": "Vessel",
  "source": "vizion"
}

How it differs from a carrier ETA

A carrier ETA arrives as the same Vessel arrived at destination port milestone with a source of carrier. The source property is what distinguishes the two.

It is Vizion's own estimate. Where the carrier publishes an ETA, the Vizion value is an independent assessment of the same arrival and the two dates can differ. A shipment may carry both.
It is only sent when Vizion is confident. When Vizion has no confident estimate for a shipment, no Vizion Predictive ETA is emitted. It will not appear on every shipment, and it can be present in one update and absent from the next.

📘
Because a Vizion Predictive ETA is only sent when Vizion has a confident estimate, design your integration to tolerate its absence. Preserve the last known ETA rather than overwriting it with a null when no estimate is present in a given update.

Filtering by source

Vizion Predictive ETAs can be included or excluded when you configure Exception Alerts, using the vizion value in the event's source filter. This lets you choose whether a change to a Vizion-generated estimate triggers an event.

Availability

Vizion Predictive ETAs are available for select accounts and are not enabled by default. Contact your Vizion representative to enable them for your organization.