Hours Worked

GET /external/v1/hours

Returns daily aggregated hours worked across all staff for a given date range.

Query Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date (ISO 8601 format, e.g. `2026-01-01`)
`to`	string	Yes	End date (ISO 8601 format, e.g. `2026-01-31`)

Response

Returns an array of objects, one per day in the range.

[
  {
    "date": "2026-01-01",
    "hours": 48.5
  },
  {
    "date": "2026-01-02",
    "hours": 52.0
  }
]

Response Fields

Field	Type	Description
`date`	string	Date in `YYYY-MM-DD` format
`hours`	number	Total hours worked across all staff that day

Example

curl -X GET "https://api.suprsync.com/external/v1/hours?from=2026-01-01&to=2026-01-31" \
  -H "x-api-key: api_your_client_id" \
  -H "x-api-secret: sec_your_client_secret"

Notes

Hours are calculated from confirmed shifts with clock-in and clock-out times.
Days with no recorded hours return 0.
The calculation uses the minimum of actual clocked time and scheduled slot duration.