List Department Join Requests

Lists pending requests to join a department.

GET

/api/v1/server/departments/{departmentId}/join-requests

Request

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

Response

200

Success

{
  "data": [
    {
      "createdAt": 1794776859830,
      "joinCode": "liberty",
      "serverId": "7294057520392310784",
      "userId": "7308965405773533184"
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 1,
  "totalPages": 1
}

You can order by createdAt (default) or userId.

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 it was created.
joinCodestringrequired
The join code they used.
serverIdstringrequired
Server ID, or department ID for department join requests.
userIdstringrequired
Melonly user ID of who asked to join.

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