How to get a container ETA ?

📘
ETA at POD vs ETA at destination
Common practice is to define the shipment ETA by the estimated time of arrival at the port of discharge. Nevertheless, some shipping lines will define the shipment ETA by the estimated time of the last know shipment event.

ETA at POD

To find the ETA at POD of a shipment, you should refer to the route.pod object of the GET /shipment response.

The date field indicates the arrival of the container at the port : the date can be Estimated (if the actual field is set to false) or Actual (if the actual field is set to true).

This data comes directly from the shipping line.

The PredictiveETA field is completed when the container is within 3 days of its arrival at POD. This data is calculation by Sinay's system based on historical AIS data, live port congestion and weather data. This data can be used to double check the shipping line's ETA's accuracy.

 "pod": {
      "location": {
        "name": "Bremerhaven",
        "state": "Bremen",
        "country": "Germany",
        "countryCode": "DE",
        "locode": "DEBRV",
        "coordinates": {
          "lat": 53.53615,
          "lng": 8.59298,
          "updatedAt": null
        },
        "timezone": "Europe/Berlin"
      },
      "date": "2023-12-01T22:00:00Z",
      "actual": false,
      "predictiveEta": null

ETA at final destination

The ETA at destination can be found with the route.postpod object of the GET /shipment response.

The date field indicates the arrival of the container at the location : the date can be Estimated (if the actual field is set to false) or Actual (if the actual field is set to true).

This data comes directly from the shipping line.

                "postpod": {
                    "actual": true,
                    "date": "2024-06-20T21:42:00Z",
                    "location": {
                        "coordinates": {
                            "lat": 9.517,
                            "lng": -13.7115,
                            "updatedAt": null
                        },
                        "country": "Guinea",
                        "countryCode": "GN",
                        "locode": "GNCKY",
                        "name": "CONAKRY",
                        "state": "Conakry Region",
                        "timezone": "Africa/Conakry"
                    },
                }

Where can I see container events ?

Container events are listed in the Container json object associated to key locations (prepol, pol, pod, postpod or any transhipment port). There, you will be able to find all details regarding the shipment voyage. This data comes directly from the shipping line.

Event data is contained in the following fields:

Field name	sample data	info
description	Gate out
eventType	EQUIPMENT
eventCode	GTOT
status	CEP
date	2023-11-07T11:16:00Z
actual	true

 "containers": [
    {
      "number": "MSKU0496560",
      "isoCode": "45G1",
      "status": "IN_TRANSIT",
      "events": [
        {
          "location": {
            "name": "Houston",
            "state": "Texas",
            "country": "United States",
            "countryCode": "US",
            "locode": "USHOU",
            "coordinates": {
              "lat": 29.76328,
              "lng": -95.36327,
              "updatedAt": null
            },
            "timezone": "America/Chicago"
          },
          "facility": {
            "name": "Houston Barbours Cut Terminal",
            "countryCode": "US",
            "locode": "USUQF",
            "bicCode": "USUQFGDQQ",
            "smdgCode": null,
            "coordinates": {
              "lat": null,
              "lng": null,
              "updatedAt": null
            }
          },
          "description": "Gate out",
          "eventType": "EQUIPMENT",
          "eventCode": "GTOT",
          "status": "CEP",
          "date": "2023-11-07T11:16:00Z",
          "isActual": true,
          "isAdditionalEvent": false,
          "routeType": "LAND",
          "transportType": null,
          "vessel": null,
          "voyage": null
        },
        {
          "location": {
            "name": "Houston",
            "state": "Texas",
            "country": "United States",
            "countryCode": "US",
            "locode": "USHOU",
            "coordinates": {
              "lat": 29.76328,
              "lng": -95.36327,
              "updatedAt": null
            },
            "timezone": "America/Chicago"
          },
          "facility": null,
          "description": "Gate in",
          "eventType": "EQUIPMENT",
          "eventCode": "GTIN",
          "status": "CGI",
          "date": "2023-11-07T12:46:00Z",
          "isActual": true,
          "isAdditionalEvent": false,
          "routeType": "LAND",
          "transportType": null,
          "vessel": null,
          "voyage": null
        },
        {
          "location": {
            "name": "Houston",
            "state": "Texas",
            "country": "United States",
            "countryCode": "US",
            "locode": "USHOU",
            "coordinates": {
              "lat": 29.76328,
              "lng": -95.36327,
              "updatedAt": null
            },
            "timezone": "America/Chicago"
          },
          "facility": null,
          "description": "Load",
          "eventType": "EQUIPMENT",
          "eventCode": "LOAD",
          "status": "CLL",
          "date": "2023-11-11T04:57:00Z",
          "isActual": true,
          "isAdditionalEvent": false,
          "routeType": "SEA",
          "transportType": null,
          "vessel": {
            "name": "MAERSK OHIO",
            "imo": 9298698,
            "callSign": "KABP",
            "mmsi": 367775000,
            "flag": "US"
          },
          "voyage": "344E"
        },
        {
          "location": {
            "name": "Houston",
            "state": "Texas",
            "country": "United States",
            "countryCode": "US",
            "locode": "USHOU",
            "coordinates": {
              "lat": 29.76328,
              "lng": -95.36327,
              "updatedAt": null
            },
            "timezone": "America/Chicago"
          },
          "facility": null,
          "description": "Vessel departure",
          "eventType": "TRANSPORT",
          "eventCode": "DEPA",
          "status": "VDL",
          "date": "2023-11-11T07:09:00Z",
          "isActual": true,
          "isAdditionalEvent": false,
          "routeType": "SEA",
          "transportType": "VESSEL",
          "vessel": {
            "name": "MAERSK OHIO",
            "imo": 9298698,
            "callSign": "KABP",
            "mmsi": 367775000,
            "flag": "US"
          },
          "voyage": "344E"
        },
        {
          "location": {
            "name": "Bremerhaven",
            "state": "Bremen",
            "country": "Germany",
            "countryCode": "DE",
            "locode": "DEBRV",
            "coordinates": {
              "lat": 53.53615,
              "lng": 8.59298,
              "updatedAt": null
            },
            "timezone": "Europe/Berlin"
          },
          "facility": {
            "name": "MSC Gate Bremerhaven Gmbh & Co. KG",
            "countryCode": "DE",
            "locode": null,
            "bicCode": null,
            "smdgCode": null,
            "coordinates": {
              "lat": null,
              "lng": null,
              "updatedAt": null
            }
          },
          "description": "Vessel arrival",
          "eventType": "TRANSPORT",
          "eventCode": "ARRI",
          "status": "VAD",
          "date": "2023-12-01T22:00:00Z",
          "isActual": false,
          "isAdditionalEvent": false,
          "routeType": "SEA",
          "transportType": "VESSEL",
          "vessel": {
            "name": "MAERSK OHIO",
            "imo": 9298698,
            "callSign": "KABP",
            "mmsi": 367775000,
            "flag": "US"
          },