---
title: "Get container route"
method: GET
path: "/containers/{id}/route"
tags: ["Containers", "Routing (Paid)"]
---

# Get container route

`GET /containers/{id}/route`

Retrieves the route details from the port of lading to the port of discharge, including transshipments. <Note>This is a paid feature. Please contact sales@terminal49.com.</Note>

## Response `200`

OK

- object
  - `data` Route
    - `id` string, uuid, required
    - `type` 'route', required
    - `attributes` object, required
      - `id` string, uuid, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `relationships` object, required
      - `cargo` object
        - `data` object
          - `id` string, uuid, required
          - `type` 'container', required
      - `shipment` object
        - `data` object
          - `id` string, uuid, required
          - `type` 'shipment', required
      - `route_locations` object
        - `data` object[]
          - `id` string, uuid, required
          - `type` 'route_location', required
  - `included` union[]
    - union
      - 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
      - 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
      - RouteLocation
        - `id` string, uuid, required
        - `type` 'route_location', required
        - `attributes` object, required
          - `id` string, uuid, required
          - `inbound_scac` string, nullable
          - `inbound_mode` 'vessel' | 'rail' | 'null', nullable
          - `inbound_eta_at` string, date-time, nullable
          - `inbound_ata_at` string, date-time, nullable
          - `inbound_voyage_number` string, nullable
          - `outbound_scac` string, nullable
          - `outbound_mode` 'vessel' | 'rail' | 'null', nullable
          - `outbound_etd_at` string, date-time, nullable
          - `outbound_atd_at` string, date-time, nullable
          - `outbound_voyage_number` string, nullable
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
        - `relationships` object, required
          - `route` object
            - `data` object
              - …
          - `inbound_vessel` object
            - `data` object, nullable
              - …
          - `outbound_vessel` object
            - `data` object, nullable
              - …
          - `location` object
            - `data` object
              - …
          - `facility` object
            - `data` object, nullable
              - …
      - 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
          - `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' | '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

## Other responses

- `403` — Forbidden - Routing data feature is not enabled for this account

## Changes

- **2025-05-28** `26213afdf412` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/terminal49/apis/terminal49-api-reference/changes/containers/:id/route/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/2ebc74307d64/schema)