Overall Equipment Effectiveness (OEE)

Track and analyze OEE metrics for your machines.

Create an OEE record

POST /oee/records

Auth: Bearer JWT (admin, operator)

curl -X POST https://api.haltless.io/api/v1/oee/records \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "machine_id": "MACHINE_UUID",
    "date": "2026-04-04",
    "availability": 92.5,
    "performance": 87.3,
    "quality": 99.1,
    "planned_production_time_minutes": 480,
    "actual_run_time_minutes": 444,
    "total_pieces": 1200,
    "good_pieces": 1189
  }'

OEE formula: OEE = Availability x Performance x Quality

List OEE records

GET /oee/records

Auth: Bearer JWT (any role)

Parameter	Type	Required	Description
machine_id	uuid	Yes	Target machine
from_date	date	No	Start date
to_date	date	No	End date

OEE summary

GET /oee/summary

Auth: Bearer JWT (any role)

Parameter	Type	Required	Description
machine_id	uuid	Yes	Target machine
days	int	No	Lookback window (1-365, default 30)

{
  "machine_id": "...",
  "period_days": 30,
  "average_oee": 79.8,
  "average_availability": 91.2,
  "average_performance": 88.5,
  "average_quality": 98.9,
  "records_count": 28
}

OEE loss categories

Category	Description
availability_loss	Unplanned downtime, changeovers
performance_loss	Reduced speed, minor stops
quality_loss	Defects, rework
not_scheduled	Planned non-production time