Tracking Stopped Events
When containers stop tracking, you can receive the webhook event container.tracking.stopped. This triggers when a container was successfully tracking, but stopped tracking for some reason.
Below is a sample payload. Notice in particular the following properties:
- The event is
container.tracking.stopped - The
changesproperty contains acompletionReason, in this casereachedLastReportableMilestone. You can use this value to tell whether this event is expected or unexpected. See below for the list of possible completion reasons.
Completion Reasons
Possible values of the completionReason property include:
| Completion Reason | Description |
|---|---|
reachedLastReportableMilestone | The container has reached the expected final milestone in its journey. Usually this is EMPTY_RETURNED, with the exception of carriers which don't report EMPTY RETURNED. |
noMoreReports | The steamship line has stopped returning data for this container on this master bill. |
unsupportedTradeType | OpenTrack supports Import, Export, and International shipments, but inland Domestic shipments (inland between two points in the US) are not supported. |
invalidTradeTypeForAccount | When the tradeType of the container does not match the tradeType of your account. If your account is set to Imports only, then this completionReason can occur if you track an Export, for example. |
timedOutAtAlternateMilestone | We received the same status from the ocean carrier for over 55 days and have terminated tracking. |
trackingCanceled | Tracking was canceled by someone on your team. |
containerLost | The steamship line cannot locate this container. |
containerDamaged | The steamship line has indicated that this container has been damaged. |
outdatedShipment | This container is an old shipment. |
newVoyageHasStarted | The steamship line has reported that this container is on a new voyage with a new master bill. |
containerMovedToNewMbl | This container was moved to a new master bill. |
container.tracking.stopped
{
"body": {
"event": "container.tracking.stopped",
"changes": {
"completionReason": {
"current": "reachedLastReportableMilestone",
"previous": null
}
},
"deliveryAttempt": 1,
"pendingRetries": 4,
"sentAt": "2023-11-14T16:59:30.213Z",
"data": {
"timestamp": "2023-11-14T16:59:29.986Z",
"createdAt": "2023-11-09T10:47:08.330Z",
"containerId": "CNTR1233607",
"scacCode": "OOLU",
"steamshipLine": "OOCL",
"lineLastFreeDay": "2023-11-10T23:59:59.999Z",
"tradeType": "import",
"equipmentType": "45G1",
"customsReleasedDate": "2023-11-08T18:25:00.000Z",
"carrierReleasedDate": "2023-11-03T18:16:00.000Z",
"confirmedOnBoardDate": "2023-10-11T08:00:00.000Z",
"vesselArrivedDate": "2023-10-31T13:40:00.000Z",
"dischargedDate": "2023-11-01T07:43:00.000Z",
"emptyReturnedDate": "2023-11-14T00:00:00.000Z",
"isRailMove": true,
"vesselName": "EVER LAUREL",
"voyageNumber": "058E",
"vesselImo": "9595474",
"vessel": {
"name": "EVER LAUREL",
"imo": "9595474",
"mmsi": "566673000"
},
"status": "EMPTY_RETURNED",
"portOfLoading": "QINGDAO",
"originPort": {
"name": "QINGDAO",
"timezone": "Asia/Shanghai",
"coordinates": {
"latitude": 36.067108,
"longitude": 120.382609
},
"unlocode": "CNQDG",
"type": "port"
},
"portOfDischarge": "LOS ANGELES, CA",
"destinationPort": {
"name": "LOS ANGELES, CA",
"timezone": "America/Los_Angeles",
"coordinates": {
"latitude": 33.7365401,
"longitude": -118.264982
},
"unlocode": "USLAX",
"type": "port"
},
"destination": "Dallas",
"origin": {
"name": "Qingdao",
"timezone": "Asia/Shanghai",
"type": "locality",
"coordinates": {
"latitude": 36.067108,
"longitude": 120.382609
}
},
"finalDestination": {
"name": "Dallas",
"timezone": "America/Chicago",
"type": "locality",
"coordinates": {
"latitude": 32.7766642,
"longitude": -96.79698789999999
},
"unlocode": "USDAL"
},
"location": "Dallas",
"currentLocation": {
"name": "Dallas",
"timezone": "America/Chicago",
"unlocode": "USDFW",
"type": "port",
"coordinates": {
"latitude": 32.7766642,
"longitude": -96.79698789999999
}
},
"lastKnownPosition": {
"coordinates": {
"latitude": 32.7766642,
"longitude": -96.7969879
}
},
"lastKnownPositionDate": "2023-11-14T00:00:00.000Z",
"holds": [],
"history": [
{
"milestone": "EMPTY_RETURNED",
"timestamp": "2023-11-14T00:00:00.000Z",
"location": {
"name": "Dallas",
"unlocode": "USDFW",
"timezone": "America/Chicago",
"type": "locality",
"coordinates": {
"latitude": 32.7766642,
"longitude": -96.79698789999999
}
}
},
{
"milestone": "FULL_OUTGATED_FROM_RAIL_FACILITY",
"timestamp": "2023-11-11T00:15:00.000Z",
"location": {
"name": "Haslet",
"unlocode": "USDAL",
"timezone": "America/Chicago",
"type": "locality",
"coordinates": {
"latitude": 32.9901037,
"longitude": -97.34967239999999
}
}
},
{
"milestone": "AVAILABLE_AT_RAIL_FACILITY",
"timestamp": "2023-11-08T18:31:00.000Z",
"location": {
"name": "Haslet",
"unlocode": "USDAL",
"timezone": "America/Chicago",
"type": "locality",
"coordinates": {
"latitude": 32.9901037,
"longitude": -97.34967239999999
}
}
},
{
"milestone": "UNLOADED_FROM_RAIL",
"timestamp": "2023-11-08T17:56:00.000Z",
"location": {
"name": "Dallas",
"timezone": "America/Chicago",
"type": "locality",
"coordinates": {
"latitude": 32.7766642,
"longitude": -96.79698789999999
}
}
},
{
"milestone": "ARRIVED_AT_RAIL_FACILITY",
"timestamp": "2023-11-08T17:56:00.000Z",
"location": {
"name": "Dallas",
"timezone": "America/Chicago",
"type": "locality",
"coordinates": {
"latitude": 32.7766642,
"longitude": -96.79698789999999
}
}
},
{
"milestone": "DEPARTED_ON_RAIL",
"timestamp": "2023-11-05T03:24:00.000Z",
"location": {
"name": "Los Angeles",
"unlocode": "USLAX",
"timezone": "America/Los_Angeles",
"type": "locality",
"coordinates": {
"latitude": 33.7365401,
"longitude": -118.264982
}
}
},
{
"milestone": "LOADED_ON_RAIL",
"timestamp": "2023-11-05T03:24:00.000Z",
"location": {
"name": "Los Angeles",
"unlocode": "USLAX",
"timezone": "America/Los_Angeles",
"type": "locality",
"coordinates": {
"latitude": 33.7365401,
"longitude": -118.264982
}
}
},
{
"milestone": "DISCHARGED",
"timestamp": "2023-11-01T07:43:00.000Z",
"location": {
"name": "LOS ANGELES, CA",
"unlocode": "USLAX",
"timezone": "America/Los_Angeles",
"type": "port",
"coordinates": {
"latitude": 33.7365401,
"longitude": -118.264982
}
},
"vessel": {
"name": "EVER LAUREL",
"imo": "9595474",
"mmsi": "566673000"
}
},
{
"milestone": "VESSEL_BERTHED",
"timestamp": "2023-10-31T13:40:00.000Z",
"location": {
"name": "LOS ANGELES, CA",
"unlocode": "USLAX",
"timezone": "America/Los_Angeles",
"type": "port",
"coordinates": {
"latitude": 33.7365401,
"longitude": -118.264982
}
},
"vessel": {
"name": "EVER LAUREL",
"imo": "9595474",
"mmsi": "566673000"
}
},
{
"milestone": "VESSEL_DEPARTED",
"timestamp": "2023-10-11T18:03:00.000Z",
"location": {
"name": "QINGDAO",
"unlocode": "CNQDG",
"timezone": "Asia/Shanghai",
"type": "port",
"coordinates": {
"latitude": 36.067108,
"longitude": 120.382609
}
},
"vessel": {
"name": "EVER LAUREL",
"imo": "9595474",
"mmsi": "566673000"
}
},
{
"milestone": "LOADED",
"timestamp": "2023-10-11T08:00:00.000Z",
"location": {
"name": "QINGDAO",
"unlocode": "CNQDG",
"timezone": "Asia/Shanghai",
"type": "port",
"coordinates": {
"latitude": 36.067108,
"longitude": 120.382609
}
},
"vessel": {
"name": "EVER LAUREL",
"imo": "9595474",
"mmsi": "566673000"
}
},
{
"milestone": "FULL_INGATED",
"timestamp": "2023-10-09T10:06:00.000Z",
"location": {
"name": "QINGDAO",
"unlocode": "CNQDG",
"timezone": "Asia/Shanghai",
"type": "port",
"coordinates": {
"latitude": 36.067108,
"longitude": 120.382609
}
}
},
{
"milestone": "EMPTY_OUTGATED",
"timestamp": "2023-10-07T21:19:00.000Z",
"location": {
"name": "Qingdao",
"unlocode": "CNQDG",
"timezone": "Asia/Shanghai",
"type": "locality",
"coordinates": {
"latitude": 36.067108,
"longitude": 120.382609
}
}
}
],
"masterBillNumber": "MBOL1236169040",
"account": {
"domain": "yourdomain.com",
"region": null
},
"railCarrier": {
"name": "BNSF RAILWAY COMPANY",
"scacCode": "BNSF"
},
"finalRailStation": {
"name": "ALLIANCE",
"firmsCode": "T926",
"fsac": "51027",
"unlocode": "USDAL"
},
"lastFreeDayAtRailStation": "2023-11-09T18:31:00.000Z",
"masterBill": {
"number": "MBOL1236169040",
"referenceNumbers": []
},
"customFields": [],
"trackingPage": "https://dashboard.opentrack.co/tracking-link-url"
}
}
}
Updated about 1 month ago