melonly logomelonly logo
melonly logo
Dashboard
Log in

List a Player's Logs

Lists the logs for a Roblox username. The username has to match how it was logged, so if a player may have changed their name, use their Roblox ID instead.

GET

/api/v1/server/logs/user/{username}

Request

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

Response

200

Success

{
  "data": [
    {
      "createdAt": 1794776859830,
      "createdBy": "7264722635089514496",
      "dontCount": false,
      "editedBy": [],
      "expired": false,
      "id": "7527833441069436928",
      "proof": [],
      "robloxId": "156",
      "serverId": "7294057520392310784",
      "text": "vdm at gas station (again)",
      "type": 0,
      "username": "Builderman"
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 1,
  "totalPages": 1
}

You can order by createdAt (default) or id.

Authorization

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

Path parameters

usernamestringrequired

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
typeinteger
Only logs of this type (0-5).
typeIdstring
Only custom logs of this custom type ID.

Response

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

createdAtintegerrequired
When it was created.
createdBystringrequired
Member ID of the staff member who created it, or SYSTEM.
editedBystring[]required
Member IDs of everyone who edited it.
idstringrequired
Unique ID.
proofstring[]required
Proof file keys.
serverIdstringrequired
Server ID.
textstringrequired
Reason.
typeintegerrequired
Log type: 0 Warning, 1 Kick, 2 Ban, 3 Ban BOLO, 4 Note or 5 Custom.
usernamestringrequired
Roblox username of the player.
completedBystring | null
For ban BOLOs, member ID of who completed it.
deniedBystring | null
For ban BOLOs, member ID of who denied it.
descriptionstring | null
Extra details.
dontCountboolean | null
Whether it's left out of punishment counts.
expiredboolean | null
Whether it has expired.
expiredAtinteger | null
When it expired.
expiredBystring | null
Member ID of who expired it.
hiddenboolean | null
Whether it's hidden from the player.
hiddenBystring | null
Member ID of who hid it.
robloxIdstring | null
Roblox user ID of the player.
tempBanboolean | null
Whether the ban is temporary.
typeIdstring | null
Custom log type ID, when type is 5.
unbanAtinteger | null
When a temporary ban ends.

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