--- title: "List shipments" method: GET path: "/shipments" tags: ["Shipments"] --- # List shipments `GET /shipments` Returns a list of your shipments. The shipments are returned sorted by creation date, with the most recent shipments appearing first. This api will return all shipments associated with the account. Shipments created via the `tracking_request` API aswell as the ones added via the dashboard will be retuned via this endpoint. ## Query parameters - `page[number]` integer - `page[size]` integer - `q` string - `include` string - `number` string - `filter[tracking_stopped]` boolean ## Response `200` OK - object - `data` Shipment[] - `id` string, uuid, required - `relationships` object, required - `destination` object - `data` object, nullable - `type` 'port' | 'metro_area', required - `id` string, uuid, required - `port_of_lading` object - `data` object, nullable - `type` 'port', required - `id` string, uuid, required - `containers` object - `data` object[] - `type` 'container', required - `id` string, uuid, required - `port_of_discharge` object - `data` object, nullable - `type` 'port', required - `id` string, uuid, required - `pod_terminal` object - `data` object - `type` 'terminal', required - `id` string, uuid, required - `destination_terminal` object - `data` object - `type` 'terminal' | 'rail_terminal', required - `id` string, uuid, required - `line_tracking_stopped_by_user` object - `data` object - `type` 'user', required - `id` string, uuid, required - `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 - `pol_atd_at` string, date-time, nullable - `pod_eta_at` string, date-time, nullable - `pod_original_eta_at` string, date-time, nullable - `pod_ata_at` string, date-time, nullable - `destination_eta_at` string, date-time, nullable - `destination_ata_at` string, date-time, nullable - `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 - `included` union[] - union - Container — Represents the equipment during a specific journey. - `id` string, uuid, required - `type` 'container', 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 - `ind_ata_at` string, date-time, nullable - `ind_rail_unloaded_at` string, date-time, nullable - `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 before demmurage accrues. Corresponding timezone is final_destination_timezone. - `pickup_lfd_line` string, date-time, nullable — The last free day as reported by the line. Corresponding timezone is final_destination_timezone or pod_timezone. - `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 - 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' - `links` Links - `last` string, uri - `next` string, uri - `prev` string, uri - `first` string, uri - `self` string, uri - `meta` Meta - `size` integer - `total` integer ## Other responses - `422` — Unprocessable Entity ## Changes - **2025-12-01** `002d787cbbc0` — 1 info - added the optional property `included/items/anyOf[subschema #1: Container model]/attributes/current_status` to the response with the `200` status - **2025-10-31** `e80cf420b790` — 1 warning - added the new `past_full_out_window` enum value to the `data/items/attributes/line_tracking_stopped_reason` response property for the response status `200` - **2025-09-30** `eecd2d93fbbd` — 2 info - added the optional property `included/items/anyOf[subschema #1: Container model]/attributes/import_deadlines` to the response with the `200` status - response property `included/items/anyOf[subschema #1: Container model]/attributes/ind_facility_lfd_on` deprecated - **2025-06-04** `b6ebdc1155a0` — 1 info - added the new optional `query` request parameter `filter[tracking_stopped]` - …earlier changes not shown [Full history](https://skmtc.dev/terminal49/apis/terminal49-api-reference/changes/shipments/get.md) --- [API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/002d787cbbc0/schema)