Dispatch caravan

post/caravans/{caravanId}/dispatch

Dispatches a loaded caravan onto its assigned trade route. All required cargo lots must be weighed, sealed, and marked ready before dispatch.

Path Parameters

caravanIdstringrequired

Responses

200OK - dispatch accepted

application/json

idstringrequired

caravan_idstringrequired

routestring ("sahara_crossing" | "oasis_loop" | "silk_road_west" | "nile_delta" | "atlas_pass")

Route assigned to the manifest

total_lotsinteger

Number of cargo lots on the manifest

total_weight_kgnumber (float)

Combined weight of all cargo lots

total_declared_valuenumber (float)

Combined declared value of all cargo lots

currencystring

Currency used for declared cargo values

lotsarray of CargoLot

idstringrequired

commoditystringrequired

Cargo category

descriptionstring

Handling guidance for this cargo lot

statusstring ("pending" | "weighed" | "sealed" | "loaded")required

quantityinteger

Count of packages, crates, bolts, jars, or bundles in the lot

Unit used to count this cargo lot

weight_kgnumber (float)

Total lot weight in kilograms

declared_valuenumber (float)

Declared value in trading dinars

origin_stallstring

Stall or warehouse where the cargo lot originated

inspection_statusstring ("not_required" | "pending" | "passed" | "held")

Current inspection result for the lot

sealed_bystring

Name of the manifest clerk who sealed the manifest

next_checkpointstring

Next expected route checkpoint

dispatched_atstring (date-time)

Errors

Request

curl -X POST 'https://api.cameltrading.example/v1/caravans/car_sahara_001/dispatch' \
  -H 'Authorization: Bearer <your-token>'

Response

{
  "id": "man_amber_2026",
  "caravan_id": "car_sahara_001",
  "status": "loading",
  "route": "sahara_crossing",
  "total_lots": 6,
  "total_weight_kg": 248.75,
  "total_declared_value": 18420.5,
  "currency": "CTD",
  "lots": [
    {
      "id": "lot_spice_042",
      "commodity": "Saffron",
      "category": "spice",
      "description": "Keep sealed in waxed linen and away from direct sun",
      "status": "weighed",
      "quantity": 12,
      "unit": "jar",
      "weight_kg": 38.5,
      "declared_value": 1240.75,
      "origin_stall": "Spice Vault 3",
      "inspection_status": "passed"
    }
  ],
  "sealed_by": "Farid al-Masri",
  "next_checkpoint": "Silver Well Oasis",
  "dispatched_at": null
}