List Department Shifts

Lists a department's shifts. Use active=true to see who's on shift.

GET

/api/v1/server/departments/{departmentId}/shifts

Request

curl -X GET "https://api.melonly.com/api/v1/server/departments/{departmentId}/shifts" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Success

{
  "data": [
    {
      "breakTimestamps": [
        {
          "endedAt": 1794777600000,
          "startedAt": 1794777000000
        }
      ],
      "createdAt": 1794776859830,
      "endedAt": 1794790000000,
      "id": "7527830759214682112",
      "memberId": "7308965405773533184",
      "serverId": "7294057520392310784",
      "type": "7400000000000000000",
      "wave": 12
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 1,
  "totalPages": 1
}

You can order by createdAt (default), endedAt or id.

Authorization

Authorizationstringrequired
Your API token as Bearer YOUR_TOKEN. Create one in your server's dashboard settings.

Path parameters

departmentIdstringrequired

Query parameters

pageintegerdefault: 1
1-based page number. Defaults to 1.
pageSizeintegerdefault: 10
Items per page, clamped to 1-100. Defaults to 10.
orderBystring
Field to sort by. See the endpoint description for the accepted values.
sortstring
Sort direction. Defaults to desc.
Allowed values:ascdesc
activeboolean
true for shifts in progress, false for ended shifts.
typestring
Only shifts of this shift type ID.

Response

200 Success. Results are paged and also include page, pageSize, total and totalPages.

breakTimestampsobject[]required
Breaks taken, oldest first. See the break object.
createdAtintegerrequired
When the shift started.
idstringrequired
Shift ID.
memberIdstringrequired
Member ID of the member on shift.
serverIdstringrequired
Server ID, or department ID for department shifts.
waveintegerrequired
Activity wave the shift counts towards.
autoEndboolean | null
Whether the shift ends automatically.
endedAtinteger | null
When the shift ended. Missing while it's active.
endedBystring | null
Member ID of who ended it, if not the member.
typestring | null
Shift type ID. Missing for the default type.

Errors

StatusMeaning
400Invalid request. validation_failed lists each invalid field in details.fields.
401Missing, invalid or expired token
404Not found
429Rate limited. See Retry-After and details.
500Internal server error