Add a cargo lot

post/caravans/{caravanId}/manifest/lots

Adds a new cargo lot to the caravan manifest.

Path Parameters

caravanIdstringrequired

The unique caravan identifier

Request Body

required

application/json

commoditystringrequired

descriptionstring

weight_kgnumber (float)

declared_valuenumber (float)

Responses

201Created

application/json

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

Errors

Request

curl -X POST 'https://api.cameltrading.example/v1/caravans/car_sahara_001/manifest/lots' \
  -H 'Authorization: Bearer <your-token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "commodity": "Saffron",
  "category": "spice",
  "description": "Keep sealed in waxed linen and away from direct sun",
  "weight_kg": 38.5,
  "declared_value": 1240.75
}'

Response

{
  "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"
}