Equipment Working Hours

Retrieves working hours for the specified date. Working hours that span across two dates will be split at 00:00.

Endpoint:

GET https://integration-api.ram.syniotec.com/analytics/v1/equipment-working-hours/:date

Params:

date — Expected in YYYY-MM-DD format (e.g., 2025-08-05)

Response

[
  {
    "id": "0755b2a1-3e9b-46b3-a55e-19a06dd2e880",
    "start": "2023-08-01T08:00:00Z",
    "end": "2023-08-01T16:00:00Z",
    "duration": 28800000,
    "equipmentId": "51266abb-225f-47e5-a41f-3b8a5b8bf3aa",
    "equipment": {
      "id": "51266abb-225f-47e5-a41f-3b8a5b8bf3aa",
      "invNumber": "9999999",
      "beaconId": "123456789012345"
    },
  }
]

Fields Description

id - Unique identifier for this record

duration - Total duration in milliseconds the equipment was active on the specified date.

start - Start time of the record, stored in Coordinated Universal Time (UTC).

end - End time of the record, stored in Coordinated Universal Time (UTC).

equipment.id - Unique identifier of the equipment (same as equipmentId)

equipment.invNumber - Inventory number of the equipment.

equipment.beaconId - Identifier of the beacon installed on the equipment (e.g., GPS tracker).


Example:

curl -X GET "https://integration-api.ram.syniotec.com/analytics/v1/equipment-working-hours/2025-08-08" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"