# Get utilization % for all machines in a factory (/docs/api-reference/monitoring/MonitoringController_getMachineUtilizations)

`GET /api/factories/{factoryId}/monitoring/utilizations`

Base URL: https://api.xentr.ai

Authentication: bearer token (`Authorization: Bearer <token>`).

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `factoryId` | path | yes | string | Factory ID |
| `from` | query | yes | string | Start time (ISO 8601) |
| `to` | query | yes | string | End time (ISO 8601) |
| `shiftId` | query | no | string | Restrict utilization to a specific shift’s hours (shift-aware, overnight + timezone correct) |

## Responses

### 200: Map of machineId to utilization %