Top Level Locations

Port locations

These locations are water-adjacent and are usually the location of a terminal that manages water-bound imports and exports.

Origin port

The origin port is the port or terminal where the container is loaded onto the vessel to begin its journey to the destination port.

The origin_port location object is typically known, and can sometimes be the same location as the inland origin if the container began its journey already at the port or terminal where it will load onto the vessel.

"origin_port": {
    "name": "Laem Chabang International Terminal (Lcit), B5/C3",
    "city": "Chon Buri",
    "state": "Chon Buri",
    "country": "Thailand",
    "unlocode": "THLCH",
    "facility_code": "LCIT",
    "facility": "LCIT",
    "geolocation": {
      "latitude": 13.05278,
      "longitude": 100.89111
    }
  }

Destination port

The destination port is the port or terminal where the container is ultimately discharged from the final vessel to either be picked up by the customer or moved onto rail or a truck to be discharged again further inland.

The destination_port location object is typically known, and can sometimes be the same location as the inland destination if the container will be picked up directly from the port or terminal where it was discharged from the vessel.

"destination_port": {
    "name": "Seagirt Marine Terminal",
    "city": "Baltimore",
    "state": "Maryland",
    "country": "United States",
    "unlocode": "USBAL",
    "facility_code": "SMT",
    "facility": "SMT",
    "geolocation": {
      "latitude": 39.255,
      "longitude": -76.54667
    }
  }

Inland locations

These locations are a facility or address that is inland or not water-adjacent like a port would be.

If this location is null in the payload, it either was not provided by the carrier or another source used to extract the tracking data, or the API does not yet have logic for that carrier to extract this information.

Inland origin

The inland origin is where a container begins its journey before arriving at the origin port to be loaded onto a vessel.

For example, if the container was picked up at a warehouse, the inland_origin location object would be that warehouse where it was likely moved by truck or rail to eventually arrive at the origin port.

"inland_origin": {
    "name": "Bangkok",
    "city": "Bangkok",
    "state": "Bangkok",
    "country": "Thailand",
    "unlocode": "THBKK",
    "facility_code": null,
    "facility": null,
    "geolocation": {
      "latitude": 13.75,
      "longitude": 100.51667
    }
}

Inland destination

The inland destination is where a container ends its journey after being discharged from a vessel at the destination port.

For example, if the container is being delivered to a warehouse, the inland_destination location object would be that warehouse where it was likely moved by truck or rail from the destination port.

"inland_destination": {
    "name": "Seagirt Marine Terminal",
    "city": "Baltimore",
    "state": "Maryland",
    "country": "United States",
    "unlocode": "USBAL",
    "facility_code": "SMT",
    "facility": "SMT",
    "geolocation": {
      "latitude": 39.255,
      "longitude": -76.54667
    }
  }