List a Member's Suspensions

Lists one member's suspensions.

GET

/api/v1/server/suspensions/user/{memberId}

Request

curl -X GET "https://api.melonly.com/api/v1/server/suspensions/user/{memberId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Success

{
  "data": [
    {
      "endAt": 1795381659830,
      "expired": false,
      "id": "7527700000000000000",
      "memberId": "7308965405773533184",
      "points": 0,
      "reason": "said \"trust me bro\" during a 10-80",
      "serverId": "7294057520392310784",
      "startedAt": 1794776859830,
      "startedBy": "7264722635089514496",
      "voided": false
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 1,
  "totalPages": 1
}

You can order by startedAt (default), endAt or id.

Authorization

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

Path parameters

memberIdstringrequired

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.

expiredbooleanrequired
Whether it has expired.
idstringrequired
Unique ID.
memberIdstringrequired
Member ID of the suspended member.
pointsintegerrequired
Points it carries.
reasonstringrequired
Why they were suspended.
serverIdstringrequired
Server ID.
startedAtintegerrequired
When it started.
startedBystringrequired
Member ID of who suspended them.
voidedbooleanrequired
Whether it has been voided.
endAtinteger | null
When it's scheduled to end. Missing for indefinite suspensions.
endedAtinteger | null
When it ended early.
endedBystring | null
Member ID of who ended it early.
endedReasonstring | null
Why it ended early.
expiredAtinteger | null
When it expired.
voidReasonstring | null
Why it was voided.
voidedBystring | null
Member ID of who voided it.

Errors

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