List Department Members

Lists a department's members.

GET

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

Request

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

Response

200

Success

{
  "data": [
    {
      "createdAt": 1794776859830,
      "customColumnValues": [],
      "departmentId": "7392336585590575104",
      "id": "7527833441069436928",
      "inactive": false,
      "inactiveLastShift": 0,
      "inactiveSince": 0,
      "rankId": "7392336600000000000",
      "rankPosition": 2,
      "roles": [],
      "supportFlags": []
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 1,
  "totalPages": 1
}

You can order by createdAt (default), rankPosition 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

Response

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

createdAtintegerrequired
When they joined the department.
customColumnValuesobject[]required
Values for the department's custom roster columns.
departmentIdstringrequired
Department ID.
idstringrequired
Unique ID.
rankIdstringrequired
ID of the member's rank.
rankPositionintegerrequired
Member's position within their rank.
rolesstring[]required
IDs of the department roles held.
supportFlagsstring[]required
Roster flags set on the member.
inactiveboolean | null
Whether they're currently flagged inactive.
inactiveLastShiftinteger | null
When their last shift ended, at the time they were flagged.
inactiveSinceinteger | null
When they were flagged inactive.

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