Equipment Usage

Endpoint:

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

The duration is aggregated per equipment per site for the given day.

Params:

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

Response

[
  {
    "duration": 12345000,
    "equipment": {
      "id": "11111111-2222-3333-4444-555555555555",
      "invNumber": "9999999",
      "beaconId": "123456789012345"
    },
    "site": {
      "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "costCenter": "8888888",
      "type": "WAREHOUSE"
    }
  }
]

Fields Description

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

equipment.id - Unique identifier of the equipment.

equipment.invNumber - Inventory number of the equipment.

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

site.id - Unique identifier of the site (either a PROJECT or a WAREHOUSE).

site.costCenter- Cost center associated with the site.

site.type - Type of the site. Possible values: "PROJECT" or "WAREHOUSE"

Example

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