Returns warehouses with zone counts, total slots, and overall utilization.

{
  "warehouses": [
    {
      "id": 1,
      "name": "Monterrey Hub",
      "location": { "lat": 25.6866, "lng": -100.3161 },
      "timezone": "America/Mexico_City",
      "zones": 5,
      "totalSlots": 120,
      "utilization": 72
    }
  ]
}

{
  "name": "Monterrey Hub",
  "location": { "lat": 25.6866, "lng": -100.3161 },
  "timezone": "America/Mexico_City",
  "floor_plan_image": "base64_or_url"
}

Returns full warehouse metadata including all zones, slot counts, and utilization breakdown.

Update name, location, timezone, or floor plan image.

Returns zones with slot counts, occupied slots, and zone-level utilization.

{
  "zones": [
    {
      "id": 1,
      "name": "Zone A",
      "zone_type": "storage",
      "color": "#3b82f6",
      "warehouseId": 1,
      "totalSlots": 40,
      "occupiedSlots": 29,
      "utilization": 72.5
    }
  ]
}

{
  "name": "Zone A",
  "zone_type": "storage",
  "color": "#3b82f6",
  "warehouseId": 1
}

Returns zone metadata, all slots, and zone-level analytics.

Update zone name, type, color, or warehouse assignment.

Returns slots with computed occupancy status from the event ledger.

Returns time-series data for zone utilization, events per hour, and incident counts.

Supports filtering by zone, status (empty, occupied, verified), and pagination.

{
  "slot_id": "A-01-01",
  "zone": "A",
  "floor_plan_polygon": [
    { "x": 10, "y": 20 },
    { "x": 50, "y": 20 },
    { "x": 50, "y": 60 },
    { "x": 10, "y": 60 }
  ],
  "constraints": {
    "max_weight_kg": 5000,
    "max_height_m": 4.0,
    "allowed_types": ["pallet", "box"]
  }
}

Returns slot metadata and derived state: isOccupied, assetBarcode, isVerified, lastEvent.

Update polygon, constraints, or zone assignment. Does not affect the event ledger.

Returns chronological events for a specific slot. Supports pagination and date filtering.

Returns assets with type, metadata, and current location (derived from events).

{
  "asset_id": "PLT-2024-00042",
  "type": "pallet",
  "weight_kg": 1250,
  "dimensions": { "length": 120, "width": 100, "height": 15 }
}

Returns asset metadata, current location, and placement history.

Returns the current slot where the asset is placed, derived from the event ledger.

Chronological list of all placement and removal events for this asset.

{
  "event_type": "PLACED",
  "slot_id": 5,
  "asset_barcode": "PLT-2024-00042",
  "operator": "op-123",
  "photo_url": "https://cloud.example.com/evidence/photo.jpg",
  "scale_weight_kg": 1250,
  "cctv_clip_url": "https://cloud.example.com/clips/cam3-14h32.mp4",
  "work_order_ref": "WO-2025-001"
}

Response includes the SHA-256 evidence_hash of the event bundle.

Supports filtering by slot_id, asset_barcode, event_type, operator, date range, and pagination via limit/offset.

Returns full event record including evidence URLs, hash, and linked CCTV clips.

Returns events within a time window and viewport bounds. Automatically selects response mode (raw, clustered, or aggregated) based on data density.

{
  "totalSlots": 200,
  "occupiedSlots": 142,
  "utilizationPercent": 71,
  "pendingVerifications": 8,
  "byZone": [
    { "zone": "A", "occupied": 45, "total": 60, "utilization": 75 }
  ]
}

Returns units processed per hour/day/week with trend data.

Returns open incidents grouped by severity and category.

Combined endpoint returning utilization, throughput, incidents, and active transport units.

Returns all floor plan images with slot counts per plan.

Accepts multipart/form-data with the blueprint image and metadata.

Returns the floor plan image URL and all associated slot polygon definitions.

Supports filtering by status, stage, operator, and priority.

Returns full record including workflow history, evidence items, and weight data.

{
  "type": "container",
  "operation": "import",
  "priority": "normal",
  "seal_number": "SEAL-2025-00042"
}

Validates all stage requirements are met before advancing. Returns validation errors if incomplete.