# Shipment types

> What each service type looks like, with one complete example per family.

Every shipment has the same [Shipment object](https://developers.gocubic.io/shipment-object.md) shape; what varies is which parts are filled in. The table shows what is typical, not guaranteed — read what is there rather than assuming a shape from `serviceType`.

| Type | Typical milestones | Carrier and bills | Cargo | Parcels |
|---|---|---|---|---|
| `OceanFCL`, `OceanFCLExpress` | Pickup → OriginPort → 0–2 TransshipmentPort → DestinationPort → Delivery | Shipping line; `masterBill`, `houseBill`, sometimes `bookingNumber` | 1–7 containers with number and seal; packages sometimes | — |
| `OceanLCL`, `OceanLCLExpress` | Same, often with `CFS`, `ConsolidationWarehouse` or `DeconsolidationWarehouse` milestones | Same | Packages, plus the shared container's number | — |
| `OceanDDP`, `OceanDDU` | As LCL or FCL; sometimes a Rail leg to an InlandTerminal; most deliver to an Amazon fulfilment centre | Same | Containers and packages | Often |
| `AirFreight`, `AirDDP`, `AirDDU` | Pickup → OriginPort (airport) → 0–3 TransshipmentPort → DestinationPort → Delivery; a `flightNumber` per leg | Airline; `masterBill` (MAWB), `houseBill` (HAWB) | Packages only; `chargeableWeight` set | Almost always on `AirDDP`/`AirDDU` |
| `AirCourier` | The full airport route, or only Pickup → Delivery | Courier company; no bills | Packages, often weight only | Yes |
| `LandTruckLTL`, `LandTruckFTL` | Pickup → (BorderCrossing) → Delivery | `carrier` is `null`, `booking` members are `null` | Packages | Rare |
| `LandRailFCL`, `LandRailLCL` | Same shape as ocean or land. Very rare. | — | — | — |

Example values are invented.

## Ocean FCL

Not yet collected: container numbers, seals, bill numbers and the second vessel are still `null`, and every date is an estimate.

```json
{
  "reference": "QB48213",
  "status": "Active",
  "serviceType": "OceanFCL",
  "mode": "Ocean",
  "incoterms": "FOB",
  "tags": [
    "PO-20931",
    "PO-20932"
  ],
  "descriptionOfGoods": "Stainless steel cookware",
  "insured": true,
  "bookingConfirmedByCarrier": true,
  "origin": {
    "city": "Ningbo",
    "state": null,
    "countryCode": "CN",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 29.8683,
      "lon": 121.544
    },
    "name": "Ningbo Hengda Housewares Co., Ltd.",
    "type": "ShippingParty"
  },
  "portOfLoading": {
    "city": "Ningbo",
    "state": null,
    "countryCode": "CN",
    "code": "CNNGB",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 29.9333,
      "lon": 121.85
    },
    "name": "Ningbo",
    "type": "Seaport"
  },
  "portOfDischarge": {
    "city": "Felixstowe",
    "state": null,
    "countryCode": "GB",
    "code": "GBFXT",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 51.9536,
      "lon": 1.3511
    },
    "name": "Felixstowe",
    "type": "Seaport"
  },
  "destination": {
    "city": "Daventry",
    "state": null,
    "countryCode": "GB",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 52.2578,
      "lon": -1.1628
    },
    "name": "Brightwell Home Ltd",
    "type": "ShippingParty"
  },
  "carrier": {
    "name": "Maersk",
    "type": "ShippingLine"
  },
  "booking": {
    "bookingNumber": "243817265",
    "masterBill": null,
    "houseBill": null,
    "cargoCutoff": "2026-10-01",
    "shippingInstructionCutoff": "2026-09-29",
    "destinationPortFreeDays": 7,
    "emptyContainerReturnFreeDays": 10
  },
  "parcels": null,
  "amazon": null,
  "cargo": {
    "totalWeight": {
      "value": 31840,
      "unit": "KG"
    },
    "totalVolume": {
      "value": 132.6,
      "unit": "CubicMeter"
    },
    "chargeableWeight": null,
    "stackable": null,
    "containers": [
      {
        "number": null,
        "type": "FortyFtHighCube",
        "sealNumber": null
      },
      {
        "number": null,
        "type": "FortyFtHighCube",
        "sealNumber": null
      }
    ],
    "packages": []
  },
  "milestones": [
    {
      "place": {
        "city": "Ningbo",
        "state": null,
        "countryCode": "CN",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 29.8683,
          "lon": 121.544
        },
        "name": "Ningbo Hengda Housewares Co., Ltd.",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": "2026-09-28",
      "arrival": null,
      "departure": {
        "date": "2026-09-29",
        "time": null,
        "actual": false
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "Pickup",
      "completed": false
    },
    {
      "place": {
        "city": "Ningbo",
        "state": null,
        "countryCode": "CN",
        "code": "CNNGB",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 29.9333,
          "lon": 121.85
        },
        "name": "Ningbo",
        "type": "Seaport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-29",
        "time": null,
        "actual": false
      },
      "departure": {
        "date": "2026-10-04",
        "time": null,
        "actual": false
      },
      "transportToNext": {
        "vessel": "MAERSK HERRERA",
        "voyageNumber": "640W",
        "flightNumber": null,
        "carrier": {
          "name": "Maersk",
          "type": "ShippingLine"
        },
        "mode": "Voyage"
      },
      "type": "OriginPort",
      "completed": false
    },
    {
      "place": {
        "city": "Gelang Patah",
        "state": null,
        "countryCode": "MY",
        "code": "MYTPP",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 1.3631,
          "lon": 103.5483
        },
        "name": "Tanjung Pelepas",
        "type": "Seaport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-10-11",
        "time": null,
        "actual": false
      },
      "departure": {
        "date": "2026-10-14",
        "time": null,
        "actual": false
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": {
          "name": "Maersk",
          "type": "ShippingLine"
        },
        "mode": "Voyage"
      },
      "type": "TransshipmentPort",
      "completed": false
    },
    {
      "place": {
        "city": "Felixstowe",
        "state": null,
        "countryCode": "GB",
        "code": "GBFXT",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 51.9536,
          "lon": 1.3511
        },
        "name": "Felixstowe",
        "type": "Seaport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-11-08",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "DestinationPort",
      "completed": false
    },
    {
      "place": {
        "city": "Daventry",
        "state": null,
        "countryCode": "GB",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 52.2578,
          "lon": -1.1628
        },
        "name": "Brightwell Home Ltd",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-11-11",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": null,
      "type": "Delivery",
      "completed": false
    }
  ],
  "currentMilestoneIndex": 0,
  "cancelledAt": null,
  "createdAt": "2026-09-08T09:31:00Z",
  "updatedAt": "2026-09-17T02:15:00Z"
}
```

## Ocean LCL

On the water. The `CFS` and `DeconsolidationWarehouse` milestones have `place: null`. The container is shared. `packages[].weight` is per pallet: 6 × 310 KG = 1860 KG.

```json
{
  "reference": "QB51907",
  "status": "Active",
  "serviceType": "OceanLCL",
  "mode": "Ocean",
  "incoterms": "EXW",
  "tags": [
    "PO-5512"
  ],
  "descriptionOfGoods": "Cotton bed linen",
  "insured": false,
  "bookingConfirmedByCarrier": true,
  "origin": {
    "city": "Mumbai",
    "state": null,
    "countryCode": "IN",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 19.076,
      "lon": 72.8777
    },
    "name": "Kavya Textiles Pvt. Ltd.",
    "type": "ShippingParty"
  },
  "portOfLoading": {
    "city": "Navi Mumbai",
    "state": null,
    "countryCode": "IN",
    "code": "INNSA",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 18.95,
      "lon": 72.95
    },
    "name": "Nhava Sheva",
    "type": "Seaport"
  },
  "portOfDischarge": {
    "city": "Hamburg",
    "state": null,
    "countryCode": "DE",
    "code": "DEHAM",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 53.5078,
      "lon": 9.9667
    },
    "name": "Hamburg",
    "type": "Seaport"
  },
  "destination": {
    "city": "Berlin",
    "state": null,
    "countryCode": "DE",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 52.52,
      "lon": 13.405
    },
    "name": "Nordlicht Wohnen GmbH",
    "type": "ShippingParty"
  },
  "carrier": {
    "name": "Hapag-Lloyd",
    "type": "ShippingLine"
  },
  "booking": {
    "bookingNumber": null,
    "masterBill": "HLCUBO1260845517",
    "houseBill": "BOM2608377",
    "cargoCutoff": "2026-09-02",
    "shippingInstructionCutoff": null,
    "destinationPortFreeDays": null,
    "emptyContainerReturnFreeDays": null
  },
  "parcels": null,
  "amazon": null,
  "cargo": {
    "totalWeight": {
      "value": 1860,
      "unit": "KG"
    },
    "totalVolume": {
      "value": 10.08,
      "unit": "CubicMeter"
    },
    "chargeableWeight": null,
    "stackable": false,
    "containers": [
      {
        "number": "HLXU8231457",
        "type": "FortyFtHighCube",
        "sealNumber": "HL4471902"
      }
    ],
    "packages": [
      {
        "type": "Pallet",
        "quantity": 6,
        "hazardous": false,
        "weight": {
          "value": 310,
          "unit": "KG"
        },
        "length": {
          "value": 120,
          "unit": "Centimeter"
        },
        "width": {
          "value": 100,
          "unit": "Centimeter"
        },
        "height": {
          "value": 140,
          "unit": "Centimeter"
        }
      }
    ]
  },
  "milestones": [
    {
      "place": {
        "city": "Mumbai",
        "state": null,
        "countryCode": "IN",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 19.076,
          "lon": 72.8777
        },
        "name": "Kavya Textiles Pvt. Ltd.",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": "2026-08-28",
      "arrival": null,
      "departure": {
        "date": "2026-08-31",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "Pickup",
      "completed": true
    },
    {
      "place": null,
      "warehouseType": "CFS",
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-08-31",
        "time": null,
        "actual": true
      },
      "departure": {
        "date": "2026-09-03",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "IntermediaryWarehouse",
      "completed": true
    },
    {
      "place": {
        "city": "Navi Mumbai",
        "state": null,
        "countryCode": "IN",
        "code": "INNSA",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 18.95,
          "lon": 72.95
        },
        "name": "Nhava Sheva",
        "type": "Seaport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-03",
        "time": null,
        "actual": true
      },
      "departure": {
        "date": "2026-09-06",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": "BERLIN EXPRESS",
        "voyageNumber": "2635W",
        "flightNumber": null,
        "carrier": {
          "name": "Hapag-Lloyd",
          "type": "ShippingLine"
        },
        "mode": "Voyage"
      },
      "type": "OriginPort",
      "completed": true
    },
    {
      "place": {
        "city": "Hamburg",
        "state": null,
        "countryCode": "DE",
        "code": "DEHAM",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 53.5078,
          "lon": 9.9667
        },
        "name": "Hamburg",
        "type": "Seaport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-29",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "DestinationPort",
      "completed": false
    },
    {
      "place": null,
      "warehouseType": "DeconsolidationWarehouse",
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-10-01",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "IntermediaryWarehouse",
      "completed": false
    },
    {
      "place": {
        "city": "Berlin",
        "state": null,
        "countryCode": "DE",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 52.52,
          "lon": 13.405
        },
        "name": "Nordlicht Wohnen GmbH",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-10-05",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": null,
      "type": "Delivery",
      "completed": false
    }
  ],
  "currentMilestoneIndex": 2,
  "cancelledAt": null,
  "createdAt": "2026-08-19T13:04:00Z",
  "updatedAt": "2026-09-15T21:48:00Z"
}
```

## Ocean DDP

Delivering to an Amazon fulfilment centre, with `incoterms: EXW`, `amazon` IDs and last-mile `parcels`. Arrived at the port of discharge; delivery is still an estimate.

```json
{
  "reference": "QB10293",
  "status": "Active",
  "serviceType": "OceanDDP",
  "mode": "Ocean",
  "incoterms": "EXW",
  "tags": [
    "PO-8841"
  ],
  "descriptionOfGoods": "Yoga mats",
  "insured": true,
  "bookingConfirmedByCarrier": true,
  "origin": {
    "city": "Shenzhen",
    "state": null,
    "countryCode": "CN",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 22.5,
      "lon": 114.1
    },
    "name": "Shenzhen Lotus Sports Goods Co., Ltd.",
    "type": "ShippingParty"
  },
  "portOfLoading": {
    "city": "Shenzhen",
    "state": null,
    "countryCode": "CN",
    "code": "CNYTN",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 22.5667,
      "lon": 114.2833
    },
    "name": "Yantian",
    "type": "Seaport"
  },
  "portOfDischarge": {
    "city": "Long Beach",
    "state": "CA",
    "countryCode": "US",
    "code": "USLGB",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 33.7542,
      "lon": -118.2165
    },
    "name": "Long Beach",
    "type": "Seaport"
  },
  "destination": {
    "city": "Moreno Valley",
    "state": "CA",
    "countryCode": "US",
    "code": null,
    "fulfillmentCenter": "Amazon",
    "coordinates": {
      "lat": 33.9,
      "lon": -117.25
    },
    "name": "ONT8",
    "type": "FulfillmentCenter"
  },
  "carrier": {
    "name": "COSCO",
    "type": "ShippingLine"
  },
  "booking": {
    "bookingNumber": null,
    "masterBill": "COSU6412345670",
    "houseBill": "SZX2607001",
    "cargoCutoff": "2026-07-05",
    "shippingInstructionCutoff": null,
    "destinationPortFreeDays": null,
    "emptyContainerReturnFreeDays": null
  },
  "parcels": {
    "carrier": "UPS",
    "trackingNumbers": [
      "1Z84R2E70312345678",
      "1Z84R2E70312345687",
      "1Z84R2E70312345696"
    ]
  },
  "amazon": {
    "fbaIds": [
      "FBA18K4TQ9ZB"
    ],
    "referenceIds": [
      "7KQ2M9XA"
    ]
  },
  "cargo": {
    "totalWeight": {
      "value": 1082,
      "unit": "KG"
    },
    "totalVolume": {
      "value": 6.486,
      "unit": "CubicMeter"
    },
    "chargeableWeight": null,
    "stackable": null,
    "containers": [
      {
        "number": "CSNU1234567",
        "type": "FortyFtHighCube",
        "sealNumber": "CN8812045"
      }
    ],
    "packages": [
      {
        "type": "Box",
        "quantity": 62,
        "hazardous": false,
        "weight": {
          "value": 17.45,
          "unit": "KG"
        },
        "length": {
          "value": 48,
          "unit": "Centimeter"
        },
        "width": {
          "value": 48,
          "unit": "Centimeter"
        },
        "height": {
          "value": 45.4,
          "unit": "Centimeter"
        }
      }
    ]
  },
  "milestones": [
    {
      "place": {
        "city": "Shenzhen",
        "state": null,
        "countryCode": "CN",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 22.5,
          "lon": 114.1
        },
        "name": "Shenzhen Lotus Sports Goods Co., Ltd.",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": "2026-07-03",
      "arrival": null,
      "departure": {
        "date": "2026-07-03",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "Pickup",
      "completed": true
    },
    {
      "place": null,
      "warehouseType": "ConsolidationWarehouse",
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-07-03",
        "time": null,
        "actual": true
      },
      "departure": {
        "date": "2026-07-06",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "IntermediaryWarehouse",
      "completed": true
    },
    {
      "place": {
        "city": "Shenzhen",
        "state": null,
        "countryCode": "CN",
        "code": "CNYTN",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 22.5667,
          "lon": 114.2833
        },
        "name": "Yantian",
        "type": "Seaport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-07-06",
        "time": null,
        "actual": true
      },
      "departure": {
        "date": "2026-07-09",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": "COSCO SHIPPING ANDES",
        "voyageNumber": "027E",
        "flightNumber": null,
        "carrier": {
          "name": "COSCO",
          "type": "ShippingLine"
        },
        "mode": "Voyage"
      },
      "type": "OriginPort",
      "completed": true
    },
    {
      "place": {
        "city": "Long Beach",
        "state": "CA",
        "countryCode": "US",
        "code": "USLGB",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 33.7542,
          "lon": -118.2165
        },
        "name": "Long Beach",
        "type": "Seaport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-07-28",
        "time": "08:00",
        "actual": true
      },
      "departure": null,
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "DestinationPort",
      "completed": true
    },
    {
      "place": null,
      "warehouseType": "DeconsolidationWarehouse",
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-07-31",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "IntermediaryWarehouse",
      "completed": false
    },
    {
      "place": {
        "city": "Moreno Valley",
        "state": "CA",
        "countryCode": "US",
        "code": null,
        "fulfillmentCenter": "Amazon",
        "coordinates": {
          "lat": 33.9,
          "lon": -117.25
        },
        "name": "ONT8",
        "type": "FulfillmentCenter"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-08-04",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": null,
      "type": "Delivery",
      "completed": false
    }
  ],
  "currentMilestoneIndex": 3,
  "cancelledAt": null,
  "createdAt": "2026-06-28T10:12:00Z",
  "updatedAt": "2026-07-29T06:40:00Z"
}
```

## Air freight

One transshipment, so two flight legs, each with its own `flightNumber` and `carrier`. `chargeableWeight` (224 KG) differs from `totalWeight` (168 KG).

```json
{
  "reference": "QB53310",
  "status": "Active",
  "serviceType": "AirFreight",
  "mode": "Air",
  "incoterms": "EXW",
  "tags": [
    "PO-77104"
  ],
  "descriptionOfGoods": "Servo motor assemblies",
  "insured": true,
  "bookingConfirmedByCarrier": true,
  "origin": {
    "city": "Hanoi",
    "state": null,
    "countryCode": "VN",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 21.0285,
      "lon": 105.8542
    },
    "name": "Red River Precision Components JSC",
    "type": "ShippingParty"
  },
  "portOfLoading": {
    "city": "Hanoi",
    "state": null,
    "countryCode": "VN",
    "code": "HAN",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 21.2212,
      "lon": 105.8072
    },
    "name": "Noi Bai International Airport",
    "type": "Airport"
  },
  "portOfDischarge": {
    "city": "Chicago",
    "state": "IL",
    "countryCode": "US",
    "code": "ORD",
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 41.9742,
      "lon": -87.9073
    },
    "name": "Chicago O'Hare International Airport",
    "type": "Airport"
  },
  "destination": {
    "city": "Elk Grove Village",
    "state": "IL",
    "countryCode": "US",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 42.0039,
      "lon": -87.9703
    },
    "name": "Lakeshore Robotics Inc.",
    "type": "ShippingParty"
  },
  "carrier": {
    "name": "Qatar Airways",
    "type": "Airline"
  },
  "booking": {
    "bookingNumber": null,
    "masterBill": "157-48213905",
    "houseBill": "HAN26091187",
    "cargoCutoff": null,
    "shippingInstructionCutoff": null,
    "destinationPortFreeDays": null,
    "emptyContainerReturnFreeDays": null
  },
  "parcels": null,
  "amazon": null,
  "cargo": {
    "totalWeight": {
      "value": 168,
      "unit": "KG"
    },
    "totalVolume": {
      "value": 1.344,
      "unit": "CubicMeter"
    },
    "chargeableWeight": {
      "value": 224,
      "unit": "KG"
    },
    "stackable": true,
    "containers": [],
    "packages": [
      {
        "type": "Box",
        "quantity": 14,
        "hazardous": false,
        "weight": {
          "value": 12,
          "unit": "KG"
        },
        "length": {
          "value": 60,
          "unit": "Centimeter"
        },
        "width": {
          "value": 40,
          "unit": "Centimeter"
        },
        "height": {
          "value": 40,
          "unit": "Centimeter"
        }
      }
    ]
  },
  "milestones": [
    {
      "place": {
        "city": "Hanoi",
        "state": null,
        "countryCode": "VN",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 21.0285,
          "lon": 105.8542
        },
        "name": "Red River Precision Components JSC",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": "2026-09-14",
      "arrival": null,
      "departure": {
        "date": "2026-09-14",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "Pickup",
      "completed": true
    },
    {
      "place": {
        "city": "Hanoi",
        "state": null,
        "countryCode": "VN",
        "code": "HAN",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 21.2212,
          "lon": 105.8072
        },
        "name": "Noi Bai International Airport",
        "type": "Airport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-15",
        "time": null,
        "actual": true
      },
      "departure": {
        "date": "2026-09-16",
        "time": "23:55",
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": "QR8955",
        "carrier": {
          "name": "Qatar Airways",
          "type": "Airline"
        },
        "mode": "Flight"
      },
      "type": "OriginPort",
      "completed": true
    },
    {
      "place": {
        "city": "Doha",
        "state": null,
        "countryCode": "QA",
        "code": "DOH",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 25.2731,
          "lon": 51.6081
        },
        "name": "Hamad International Airport",
        "type": "Airport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-17",
        "time": "04:10",
        "actual": true
      },
      "departure": {
        "date": "2026-09-18",
        "time": "08:30",
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": "QR8141",
        "carrier": {
          "name": "Qatar Airways",
          "type": "Airline"
        },
        "mode": "Flight"
      },
      "type": "TransshipmentPort",
      "completed": true
    },
    {
      "place": {
        "city": "Chicago",
        "state": "IL",
        "countryCode": "US",
        "code": "ORD",
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 41.9742,
          "lon": -87.9073
        },
        "name": "Chicago O'Hare International Airport",
        "type": "Airport"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-18",
        "time": "15:05",
        "actual": true
      },
      "departure": null,
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "DestinationPort",
      "completed": true
    },
    {
      "place": {
        "city": "Elk Grove Village",
        "state": "IL",
        "countryCode": "US",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 42.0039,
          "lon": -87.9703
        },
        "name": "Lakeshore Robotics Inc.",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-22",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": null,
      "type": "Delivery",
      "completed": false
    }
  ],
  "currentMilestoneIndex": 3,
  "cancelledAt": null,
  "createdAt": "2026-09-09T07:22:00Z",
  "updatedAt": "2026-09-18T20:41:00Z"
}
```

## Air courier

Delivered. Only two milestones, so `portOfLoading` and `portOfDischarge` are `null`. Packages have weight but no dimensions.

```json
{
  "reference": "QB54002",
  "status": "Delivered",
  "serviceType": "AirCourier",
  "mode": "Air",
  "incoterms": "EXW",
  "tags": [],
  "descriptionOfGoods": "Leather handbag samples",
  "insured": false,
  "bookingConfirmedByCarrier": true,
  "origin": {
    "city": "Istanbul",
    "state": null,
    "countryCode": "TR",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 41.0082,
      "lon": 28.9784
    },
    "name": "Anatolia Leather Workshop",
    "type": "ShippingParty"
  },
  "portOfLoading": null,
  "portOfDischarge": null,
  "destination": {
    "city": "Tel Aviv-Yafo",
    "state": null,
    "countryCode": "IL",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 32.0853,
      "lon": 34.7818
    },
    "name": "Studio Noa Ltd.",
    "type": "ShippingParty"
  },
  "carrier": {
    "name": "DHL",
    "type": "Courier"
  },
  "booking": {
    "bookingNumber": null,
    "masterBill": null,
    "houseBill": null,
    "cargoCutoff": null,
    "shippingInstructionCutoff": null,
    "destinationPortFreeDays": null,
    "emptyContainerReturnFreeDays": null
  },
  "parcels": {
    "carrier": "DHL",
    "trackingNumbers": [
      "4839201754",
      "4839201765"
    ]
  },
  "amazon": null,
  "cargo": {
    "totalWeight": {
      "value": 16.4,
      "unit": "KG"
    },
    "totalVolume": null,
    "chargeableWeight": {
      "value": 16.5,
      "unit": "KG"
    },
    "stackable": null,
    "containers": [],
    "packages": [
      {
        "type": "Box",
        "quantity": 2,
        "hazardous": false,
        "weight": {
          "value": 8.2,
          "unit": "KG"
        },
        "length": null,
        "width": null,
        "height": null
      }
    ]
  },
  "milestones": [
    {
      "place": {
        "city": "Istanbul",
        "state": null,
        "countryCode": "TR",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 41.0082,
          "lon": 28.9784
        },
        "name": "Anatolia Leather Workshop",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": "2026-09-07",
      "arrival": null,
      "departure": {
        "date": "2026-09-08",
        "time": null,
        "actual": true
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": {
          "name": "DHL",
          "type": "Courier"
        },
        "mode": "Flight"
      },
      "type": "Pickup",
      "completed": true
    },
    {
      "place": {
        "city": "Tel Aviv-Yafo",
        "state": null,
        "countryCode": "IL",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 32.0853,
          "lon": 34.7818
        },
        "name": "Studio Noa Ltd.",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-11",
        "time": "14:20",
        "actual": true
      },
      "departure": null,
      "transportToNext": null,
      "type": "Delivery",
      "completed": true
    }
  ],
  "currentMilestoneIndex": 1,
  "cancelledAt": null,
  "createdAt": "2026-09-04T11:50:00Z",
  "updatedAt": "2026-09-11T11:26:00Z"
}
```

## Land truck

LTL with a border crossing, before pickup. Cargo is recorded in pounds, inches and cubic feet.

```json
{
  "reference": "QB52764",
  "status": "Active",
  "serviceType": "LandTruckLTL",
  "mode": "Land",
  "incoterms": null,
  "tags": [
    "PO-3307"
  ],
  "descriptionOfGoods": "Injection-moulded cooler lids",
  "insured": false,
  "bookingConfirmedByCarrier": false,
  "origin": {
    "city": "Apodaca",
    "state": null,
    "countryCode": "MX",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 25.7815,
      "lon": -100.1886
    },
    "name": "Industrias Regio Plasticos S.A. de C.V.",
    "type": "ShippingParty"
  },
  "portOfLoading": null,
  "portOfDischarge": null,
  "destination": {
    "city": "Dallas",
    "state": "TX",
    "countryCode": "US",
    "code": null,
    "fulfillmentCenter": null,
    "coordinates": {
      "lat": 32.7767,
      "lon": -96.797
    },
    "name": "Trinity Outdoor Supply LLC",
    "type": "ShippingParty"
  },
  "carrier": null,
  "booking": {
    "bookingNumber": null,
    "masterBill": null,
    "houseBill": null,
    "cargoCutoff": null,
    "shippingInstructionCutoff": null,
    "destinationPortFreeDays": null,
    "emptyContainerReturnFreeDays": null
  },
  "parcels": null,
  "amazon": null,
  "cargo": {
    "totalWeight": {
      "value": 7600,
      "unit": "LB"
    },
    "totalVolume": {
      "value": 533.3,
      "unit": "CubicFeet"
    },
    "chargeableWeight": null,
    "stackable": false,
    "containers": [],
    "packages": [
      {
        "type": "Pallet",
        "quantity": 8,
        "hazardous": false,
        "weight": {
          "value": 950,
          "unit": "LB"
        },
        "length": {
          "value": 48,
          "unit": "Inch"
        },
        "width": {
          "value": 40,
          "unit": "Inch"
        },
        "height": {
          "value": 60,
          "unit": "Inch"
        }
      }
    ]
  },
  "milestones": [
    {
      "place": {
        "city": "Apodaca",
        "state": null,
        "countryCode": "MX",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 25.7815,
          "lon": -100.1886
        },
        "name": "Industrias Regio Plasticos S.A. de C.V.",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": "2026-09-21",
      "arrival": null,
      "departure": {
        "date": "2026-09-22",
        "time": null,
        "actual": false
      },
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "Pickup",
      "completed": false
    },
    {
      "place": null,
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-23",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": {
        "vessel": null,
        "voyageNumber": null,
        "flightNumber": null,
        "carrier": null,
        "mode": "Truck"
      },
      "type": "BorderCrossing",
      "completed": false
    },
    {
      "place": {
        "city": "Dallas",
        "state": "TX",
        "countryCode": "US",
        "code": null,
        "fulfillmentCenter": null,
        "coordinates": {
          "lat": 32.7767,
          "lon": -96.797
        },
        "name": "Trinity Outdoor Supply LLC",
        "type": "ShippingParty"
      },
      "warehouseType": null,
      "cargoReadyDate": null,
      "arrival": {
        "date": "2026-09-25",
        "time": null,
        "actual": false
      },
      "departure": null,
      "transportToNext": null,
      "type": "Delivery",
      "completed": false
    }
  ],
  "currentMilestoneIndex": 0,
  "cancelledAt": null,
  "createdAt": "2026-09-15T16:08:00Z",
  "updatedAt": "2026-09-18T09:12:00Z"
}
```