--- title: "Get a container's transport events" method: GET path: "/containers/{id}/transport_events" tags: ["Containers"] --- # Get a container's transport events `GET /containers/{id}/transport_events` Get a list of past transport events (canonical) for a container. All data has been normalized across all carriers. These are a verified subset of the raw events may also be sent as Webhook Notifications to a webhook endpoint. This does not provide any estimated future events. See `container/:id/raw_events` endpoint for that. ## Query parameters - `include` string ## Response `200` OK - object - `data` TransportEvent[] - `id` string, uuid, required - `type` 'transport_event', required - `attributes` object - `event` 'container.transport.vessel_arrived' | 'container.transport.estimated.vessel_arrived' | 'container.transport.vessel_discharged' | 'container.transport.vessel_loaded' | 'container.transport.vessel_departed' | 'container.transport.estimated.vessel_departed' | 'container.transport.rail_departed' | 'container.transport.rail_arrived' | 'container.transport.rail_loaded' | 'container.transport.rail_unloaded' | 'container.transport.transshipment_arrived' | 'container.transport.transshipment_discharged' | 'container.transport.transshipment_loaded' | 'container.transport.transshipment_departed' | 'container.transport.feeder_arrived' | 'container.transport.feeder_discharged' | 'container.transport.feeder_loaded' | 'container.transport.feeder_departed' | 'container.transport.empty_out' | 'container.transport.full_in' | 'container.transport.full_out' | 'container.transport.empty_in' | 'container.transport.vessel_berthed' | 'container.transport.arrived_at_inland_destination' | 'container.transport.estimated.arrived_at_inland_destination' | 'container.pickup_lfd.changed' | 'container.pickup_lfd_line.changed' | 'container.pickup_lfd_terminal.changed' | 'container.pickup_lfd_rail.changed' | 'container.pickup_appointment.changed' | 'container.transport.available' | 'container.transport.not_available' | 'container.transport.delivered' | 'document.extracted' | 'document.extraction_failed' - `voyage_number` string, nullable - `timestamp` string, date-time, nullable - `timezone` string, nullable — IANA tz - `location_locode` string, nullable — UNLOCODE of the event location - `created_at` string, date-time - `data_source` 'shipping_line' | 'terminal' | 'ais' — The original source of the event data - `relationships` object - `shipment` object - `data` object - `id` string, uuid - `type` 'shipment' - `location` object - `data` object, nullable - `id` string, uuid - `type` 'port' | 'metro_area' - `vessel` object - `data` object, nullable - `id` string, uuid - `name` 'vessel' - `terminal` object - `data` object, nullable - `id` string, uuid - `type` 'terminal' | 'rail_terminal' - `container` object - `data` object - `id` string, uuid - `type` 'container' - `included` union[] - union - Shipment - `id` string, uuid, required - `relationships` object, required - `destination` object - `data` object, nullable - … - `port_of_lading` object - `data` object, nullable - … - `containers` object - `data` object[] - … - `port_of_discharge` object - `data` object, nullable - … - `pod_terminal` object - `data` object - … - `destination_terminal` object - `data` object - … - `line_tracking_stopped_by_user` object - `data` object - … - `attributes` object, required - `bill_of_lading_number` string, required - `normalized_number` string — The normalized version of the shipment number used for querying the carrier - `ref_numbers` string[], nullable - `created_at` string, date-time - `tags` string[] - `port_of_lading_locode` string, nullable — UN/LOCODE - `port_of_lading_name` string, nullable - `port_of_discharge_locode` string, nullable — UN/LOCODE - `port_of_discharge_name` string, nullable - `destination_locode` string, nullable — UN/LOCODE - `destination_name` string, nullable - `shipping_line_scac` string - `shipping_line_name` string - `shipping_line_short_name` string - `customer_name` string, nullable - `pod_vessel_name` string, nullable - `pod_vessel_imo` string, nullable - `pod_voyage_number` string, nullable - `pol_etd_at` string, date-time, nullable — Estimated Time of Departure from the Port of Lading, as reported by the shipping line. Carrier dependent; may be null. - `pol_atd_at` string, date-time, nullable — Actual Time of Departure from the Port of Lading. Populated after the vessel has departed the origin port. - `pod_eta_at` string, date-time, nullable — Estimated Time of Arrival at the Port of Discharge. - `pod_original_eta_at` string, date-time, nullable — Initial Estimated Time of Arrival at the Port of Discharge, as first reported by the shipping line. - `pod_ata_at` string, date-time, nullable — Actual Time of Arrival at the Port of Discharge. - `destination_eta_at` string, date-time, nullable — Estimated Time of Arrival at the shipment's destination, as reported by the shipping line. For inland (rail) moves, see also the container-level `ind_eta_at`, which is reported by the rail carrier. Corresponding timezone is `destination_timezone`. - `destination_ata_at` string, date-time, nullable — Actual Time of Arrival at the shipment's destination, as reported by the shipping line. For inland (rail) moves, see also the container-level `ind_ata_at`, which is reported by the rail carrier. Corresponding timezone is `destination_timezone`. - `pol_timezone` string, nullable — IANA tz - `pod_timezone` string, nullable — IANA tz - `destination_timezone` string, nullable — IANA tz - `line_tracking_last_attempted_at` string, date-time, nullable — When Terminal49 last tried to update the shipment status from the shipping line - `line_tracking_last_succeeded_at` string, date-time, nullable — When Terminal49 last successfully updated the shipment status from the shipping line - `line_tracking_stopped_at` string, date-time, nullable — When Terminal49 stopped checking at the shipping line - `line_tracking_stopped_reason` 'all_containers_terminated' | 'past_arrival_window' | 'past_full_out_window' | 'no_updates_at_line' | 'cancelled_by_user' | 'booking_cancelled' | 'null', nullable — The reason Terminal49 stopped checking - `type` 'shipment', required - `links` object, required - `self` string, uri, required - Container — Represents the equipment during a specific journey. - `id` string, uuid, required - `type` 'account', required - `attributes` object, required - `number` string - `ref_numbers` string[] - `equipment_type` 'dry' | 'reefer' | 'open top' | 'flat rack' | 'bulk' | 'tank' | 'null', nullable - `equipment_length` null | 10 | 20 | 40 | 45, nullable - `equipment_height` 'standard' | 'high_cube' | 'null', nullable - `weight_in_lbs` number, nullable - `created_at` string, date-time - `seal_number` string, nullable - `pickup_lfd` string, date-time, nullable — Coalesces `import_deadlines` values giving preference to `pickup_lfd_line` - `pickup_appointment_at` string, date-time, nullable — When available the pickup appointment time at the terminal is returned. - `availability_known` boolean — Whether Terminal 49 is receiving availability status from the terminal. - `available_for_pickup` boolean, nullable — If availability_known is true, then whether container is available to be picked up at terminal. - `pod_arrived_at` string, date-time, nullable — Time the vessel arrived at the POD - `pod_discharged_at` string, date-time, nullable — Discharge time at the port of discharge - `pod_full_out_at` string, date-time, nullable — Full Out time at port of discharge. Null for inland moves. - `terminal_checked_at` string, date-time, nullable — When the terminal was last checked. - `pod_full_out_chassis_number` string, nullable — The chassis number used when container was picked up at POD (if available) - `location_at_pod_terminal` string, nullable — Location at port of discharge terminal - `final_destination_full_out_at` string, date-time, nullable — Pickup time at final destination for inland moves. - `empty_terminated_at` string, date-time, nullable — Time empty container was returned. - `holds_at_pod_terminal` TerminalHold[] - `name` string, required - `status` 'pending' | 'hold', required - `description` string, nullable — Text description from the terminal (if any) - `fees_at_pod_terminal` TerminalFee[] - `type` 'demurrage' | 'exam' | 'extended_dwell_time' | 'other' | 'total', required - `amount` number, required — The fee amount in local currency - `currency_code` string — The ISO 4217 currency code of the fee is charged in. E.g. USD - `pod_timezone` string, nullable — IANA tz. Applies to attributes pod_arrived_at, pod_discharged_at, pickup_appointment_at, pod_full_out_at. - `final_destination_timezone` string, nullable — IANA tz. Applies to attribute final_destination_full_out_at. - `empty_terminated_timezone` string, nullable — IANA tz. Applies to attribute empty_terminated_at. - `pod_rail_carrier_scac` string, nullable — The SCAC of the rail carrier for the pickup leg of the container's journey.(BETA) - `ind_rail_carrier_scac` string, nullable — The SCAC of the rail carrier for the delivery leg of the container's journey.(BETA) - `pod_last_tracking_request_at` string, date-time, nullable - `shipment_last_tracking_request_at` string, date-time, nullable - `pod_rail_loaded_at` string, date-time, nullable - `pod_rail_departed_at` string, date-time, nullable - `ind_eta_at` string, date-time, nullable — Estimated Time of Arrival at the inland destination, as reported by the rail carrier. For the shipping-line view at the shipment's destination, see `destination_eta_at` on the shipment. Corresponding timezone is `final_destination_timezone`. - `ind_ata_at` string, date-time, nullable — Actual Time of Arrival at the inland destination, as reported by the rail carrier. For the shipping-line view at the shipment's destination, see `destination_ata_at` on the shipment. Corresponding timezone is `final_destination_timezone`. - `ind_rail_unloaded_at` string, date-time, nullable — Time when the container is unloaded from rail at the inland destination. - `ind_facility_lfd_on` string, date-time, nullable — Please use `import_deadlines.pickup_lfd_rail` - `import_deadlines` object, nullable — Import pickup deadlines for the container - `pickup_lfd_terminal` string, date-time, nullable — The last free day for pickup before demmurage accrues. Corresponding timezone is pod_timezone. - `pickup_lfd_rail` string, date-time, nullable — The last free day for pickup at the inland destination, as reported by the rail carrier. Corresponding timezone is final_destination_timezone. Subscribe to `container.pickup_lfd_rail.changed` to be notified of updates. - `pickup_lfd_line` string, date-time, nullable — The last free day as reported by the shipping line (carrier dependent). Corresponding timezone is final_destination_timezone or pod_timezone. Preferred source for the coalesced top-level `pickup_lfd` field. - `current_status` 'new' | 'on_ship' | 'available' | 'not_available' | 'grounded' | 'on_rail' | 'picked_up' | 'off_dock' | 'delivered' | 'dropped' | 'loaded' | 'empty_returned' | 'awaiting_inland_transfer' — The current status of the container in its journey. [Read guide to learn more.](/api-docs/in-depth-guides/container-statuses) - `relationships` object - `shipment` object - `data` object - … - `pickup_facility` object - `data` object - … - `pod_terminal` object - `data` object - … - `transport_events` object - `data` object[] - … - `raw_events` object - `data` object[] - … - Port - `id` string, uuid, required - `attributes` object - `name` string - `code` string — UN/LOCODE - `state_abbr` string, nullable - `city` string, nullable - `country_code` string — 2 digit country code - `time_zone` string — IANA tz - `latitude` number, nullable - `longitude` number, nullable - `type` 'port', required - MetroArea - `id` string, uuid, required - `attributes` object - `name` string - `code` string — UN/LOCODE - `state_abbr` string, nullable - `country_code` string - `time_zone` string — IANA tz - `latitude` number, nullable - `longitude` number, nullable - `type` 'metro_area', required - string - Terminal - `id` string, uuid - `relationships` object, required - `port` object, required - `data` object - … - `attributes` object, required - `name` string, required - `nickname` string - `firms_code` string — CBP FIRMS Code or CBS Sublocation Code - `smdg_code` string — SMDG Code - `bic_facility_code` string — BIC Facility Code - `street` string — Street part of the address - `city` string — City part of the address - `state` string — State part of the address - `state_abbr` string — State abbreviation for the state - `zip` string — ZIP code part of the address - `country` string — Country part of the address - `type` 'terminal' - RailTerminal - `id` string, uuid - `relationships` object - `port` object - `data` object, nullable - … - `metro_area` object - `data` object - … - `attributes` object, required - `name` string, required - `nickname` string - `firms_code` string — CBP FIRMS Code or CBS Sublocation Code - `type` 'rail_terminal' - Vessel - `id` string, uuid - `type` 'vessel' - `attributes` object - `name` string — The name of the ship or vessel - `imo` string, nullable — International Maritime Organization (IMO) number - `mmsi` string, nullable — Maritime Mobile Service Identity (MMSI) - `latitude` number, nullable — The current latitude position of the vessel - `longitude` number, nullable — The current longitude position of the vessel - `nautical_speed_knots` number, nullable — The current speed of the ship in knots (nautical miles per hour) - `navigational_heading_degrees` number, nullable — The current heading of the ship in degrees, where 0 is North, 90 is East, 180 is South, and 270 is West - `position_timestamp` string, nullable — The timestamp of when the ship's position was last recorded, in ISO 8601 date and time format - `positions` object[], nullable — An array of historical position data for the vessel. Only included if `show_positions` is true. - `latitude` number - `longitude` number - `heading` number, nullable - `timestamp` string, date-time - `estimated` boolean - `links` Links - `last` string, uri - `next` string, uri - `prev` string, uri - `first` string, uri - `self` string, uri - `meta` Meta - `size` integer - `total` integer --- [API](https://skmtc.net/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.net/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/versions/05ac7931d5a1/schema)