Get a container's raw events

Retrieve raw, carrier-sourced container events from the Terminal49 API. Note: deprecated — use transport events for normalized milestone data instead.

GET /containers/{id}/raw_events

Get a container's raw events

cURL

curl --request GET \
  --url https://api.terminal49.com/v2/containers/{id}/raw_events \
  --header 'Authorization: <api-key>'

200

{
  "data": [
    {
      "id": "ca6b760f-13e9-4bf6-ab49-3cf2e40757fb",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-03-03T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-03-03",
        "estimated_at": null,
        "actual_at": null,
        "event": "empty_out",
        "index": 0,
        "original_event": "Truck Gate out empty",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": null,
        "location_name": "Oakland",
        "location_locode": null,
        "vessel_name": null,
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": null
        }
      }
    },
    {
      "id": "bcdfc796-0570-4c85-9336-d6c7d0da02d2",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-03-09T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-03-09",
        "estimated_at": null,
        "actual_at": null,
        "event": "full_in",
        "index": 1,
        "original_event": "Truck Arrival in",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": null,
        "location_name": null,
        "location_locode": null,
        "vessel_name": null,
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": null
        }
      }
    },
    {
      "id": "a4ff01b0-b374-4123-ae65-3dc0c7ea41ea",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-03-14T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-03-14",
        "estimated_at": null,
        "actual_at": null,
        "event": "vessel_loaded",
        "index": 2,
        "original_event": "Vessel Loaded",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "FA009R",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "MSC FAITH",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "4b473d0e-7073-4171-8b5b-15e71e9e13cc",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "ca5862ef-6e27-4245-a281-0cec6bbe1fb7",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-03-15T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-03-15",
        "estimated_at": null,
        "actual_at": null,
        "event": "vessel_departed",
        "index": 3,
        "original_event": "Vessel departed",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "FA009R",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "MSC FAITH",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "4b473d0e-7073-4171-8b5b-15e71e9e13cc",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "f47a903e-e6d1-41c5-aec6-8401b2abf297",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-03-25T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-03-25",
        "estimated_at": null,
        "actual_at": null,
        "event": "transshipment_arrived",
        "index": 4,
        "original_event": "Vessel arrived",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "FA009R",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "MSC FAITH",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "4b473d0e-7073-4171-8b5b-15e71e9e13cc",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "72a1a13b-a2e0-4ac0-851d-eec41e9e9087",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-03-25T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-03-25",
        "estimated_at": null,
        "actual_at": null,
        "event": "transshipment_discharged",
        "index": 5,
        "original_event": "Vessel Discharged",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "FA009R",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "MSC FAITH",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "4b473d0e-7073-4171-8b5b-15e71e9e13cc",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "cd91f0cf-ee73-4c47-b99f-63245cb5bc96",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-04-07T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-04-07",
        "estimated_at": null,
        "actual_at": null,
        "event": "transshipment_loaded",
        "index": 6,
        "original_event": "Vessel Loaded",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "15W10",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "SINGAPORE EXPRESS",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "561dbb7e-c3ab-4e63-b09b-957878b1425f",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-04-07T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-04-07",
        "estimated_at": null,
        "actual_at": null,
        "event": "transshipment_departed",
        "index": 7,
        "original_event": "Vessel departed",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "15W10",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "SINGAPORE EXPRESS",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "551711a6-62ad-4205-8da2-00e0c0cbd2db",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-04-12T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-04-12",
        "estimated_at": null,
        "actual_at": null,
        "event": "vessel_arrived",
        "index": 8,
        "original_event": "Vessel arrived",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "15W10",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "SINGAPORE EXPRESS",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "f4027470-75ca-4e2a-b4f0-47654a25ac48",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-04-13T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-04-13",
        "estimated_at": null,
        "actual_at": null,
        "event": "vessel_discharged",
        "index": 9,
        "original_event": "Vessel Discharged",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": "15W10",
        "location_name": null,
        "location_locode": null,
        "vessel_name": "SINGAPORE EXPRESS",
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": {
            "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36",
            "type": "vessel"
          }
        }
      }
    },
    {
      "id": "50f11e4f-411e-48e2-8141-64226500df9c",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-04-14T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-04-14",
        "estimated_at": null,
        "actual_at": null,
        "event": "full_out",
        "index": 10,
        "original_event": "Truck Departure from",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": null,
        "location_name": null,
        "location_locode": null,
        "vessel_name": null,
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": null
        }
      }
    },
    {
      "id": "49aea23c-b8c5-4a97-b133-f7a9723fa1b4",
      "type": "raw_event",
      "attributes": {
        "timestamp": "2020-04-15T00:00:00Z",
        "estimated": false,
        "actual_on": "2020-04-15",
        "estimated_at": null,
        "actual_at": null,
        "event": "empty_in",
        "index": 11,
        "original_event": "Truck Gate in empty",
        "created_at": "2020-04-18T00:18:27Z",
        "voyage_number": null,
        "location_name": null,
        "location_locode": null,
        "vessel_name": null,
        "vessel_imo": null,
        "timezone": null
      },
      "relationships": {
        "location": {
          "data": null
        },
        "vessel": {
          "data": null
        }
      }
    }
  ],
  "included": [
    {
      "id": "4b473d0e-7073-4171-8b5b-15e71e9e13cc",
      "type": "vessel",
      "attributes": {
        "name": "MSC FAITH",
        "imo": null,
        "mmsi": "636019213",
        "latitude": 70.22625823437389,
        "longitude": 45.06279126658865,
        "nautical_speed_knots": 100,
        "navigational_heading_degrees": 1,
        "position_timestamp": "2023-06-05T19:46:18Z"
      }
    },
    {
      "id": "345c05ab-4217-4ffe-a1a4-6c03b9ad2b36",
      "type": "vessel",
      "attributes": {
        "name": "SINGAPORE EXPRESS",
        "imo": null,
        "mmsi": "477300500",
        "latitude": 70.22625823437389,
        "longitude": 45.06279126658865,
        "nautical_speed_knots": 100,
        "navigational_heading_degrees": 1,
        "position_timestamp": "2023-06-05T19:46:18Z"
      }
    }
  ]
}

This endpoint is deprecated. For past milestone data, use Get a container’s transport events.

Returns past and estimated future milestones for a container as reported by the carrier. The event and timestamp attributes are normalized where possible; other attributes are passed through as-is. Not every value in event has a normalized name — container movement events are usually normalized, but exceptions occur.

The response includes an original_event field with the raw carrier event name, which is not present on transport_events.

raw_events vs transport_events

	raw_events	transport_events
Status	Deprecated	Recommended
Source	Carrier feed, mostly as-is	Vetted and normalized across carriers
Estimated events	Any event type can be estimated, flagged by attributes.estimated	Only three normalized estimated.* event types (see below)
Includes original_event	Yes	No
Data quality	More events, less consistent normalization	Fewer events, higher confidence

Use transport_events for past milestones. Use raw_events only when you need the carrier’s original event name or estimated events that have no transport_events equivalent.

Estimated events

In raw_events, any event type can carry an estimated timestamp. The attributes.estimated boolean is true when the timestamp is an estimate, so estimated feeder, rail, and transshipment events appear here.

In transport_events, estimates are separate event types, and only three exist:

• container.transport.estimated.vessel_departed
• container.transport.estimated.vessel_arrived
• container.transport.estimated.arrived_at_inland_destination

There are no estimated equivalents for feeder, rail, or transshipment events in transport_events. If you need estimated timestamps for those milestones, raw_events is currently the only endpoint that provides them.

Authorizations

Authorization · string · header · required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Path Parameters

id · string · required

Response

200 - application/json

OK

data · Raw Event Model · object[]

Show child attributes