Get manual operating hours by equipment ID

Endpoint

GET /equipments/{equipmentId}/manual-operating-hours

Authentication

Required: Authorization header with valid token

Path Parameters

ParameterTypeRequiredDescriptionExample
equipmentIduuidYesThe equipment to read the value for8f14e45f-ceea-467a-9f4d-1a2b3c4d5e6f

Response

Success (200)

{
  "equipmentId": "8f14e45f-ceea-467a-9f4d-1a2b3c4d5e6f",
  "minutes": 75030,
  "updatedBy": "user-uuid",
  "updatedAt": "2026-08-10T09:00:00.000Z"
}

An equipment that exists but has no value set returns 200 with "minutes": null. If the equipment is not known to the platform yet, the request fails with 404 EQUIPMENT_NOT_FOUND.

Response Field Descriptions:

See ManualOperatingHours Schema

Error

See Error Schema documentation

Example Usage

Bash

curl -X GET "https://integration-api.ram.syniotec.com/master-data/v1/equipment-telemetry/equipments/8f14e45f-ceea-467a-9f4d-1a2b3c4d5e6f/manual-operating-hours" \
 -H "Authorization: Bearer YOUR_TOKEN"