melonly logomelonly logo
melonly logo
Dashboard
Log in

List Applications

Lists your server's forms.

GET

/api/v1/server/applications

Request

curl -X GET "https://api.melonly.com/api/v1/server/applications" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Success

{
  "data": [
    {
      "acceptingResponses": true,
      "banAppealNote": false,
      "createdAt": 1794776859830,
      "description": "please read the rules before applying",
      "id": "7400100000000000000",
      "questions": {},
      "sections": [],
      "serverId": "7294057520392310784",
      "title": "Game Moderator Application",
      "type": 0
    }
  ],
  "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.

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.

acceptingResponsesbooleanrequired
Whether the form is open.
banAppealNotebooleanrequired
Whether ban appeals show the ban log to reviewers.
createdAtintegerrequired
When it was created.
descriptionstringrequired
Form description.
idstringrequired
Unique ID.
questionsobjectrequired
The form's questions.
sectionsobjectrequired
The form's sections.
serverIdstringrequired
Server ID, or department ID for department forms.
titlestringrequired
Form title.
acceptanceRemoveRolesobject | null
Discord roles removed when approved.
allowMultipleSubmissionsboolean | null
Whether people can submit more than once.
appealCooldowninteger | null
Days between ban appeals.
approvalRolesobject | null
Discord roles given when approved.
bannerKeystring | null
Banner image key.
blockedDiscordRolesobject | null
Discord roles that can't apply.
closedMessagestring | null
Message shown while the form is closed.
collectRobloxAccountboolean | null
Whether the applicant's Roblox account is collected.
colorstring | null
Hex colour.
cooldowninteger | null
Hours before someone can apply again.
defaultQuestionPointValueinteger | null
Default points per quiz question.
denialRemoveRolesobject | null
Discord roles removed when denied.
denialRolesobject | null
Discord roles given when denied.
eventsChannelIdstring | null
Discord channel for new submissions.
folderIdstring | null
Folder the form is in.
giveRolesOnApprovalobject | null
Melonly roles given when approved.
guildMemberAgeinteger | null
Days applicants must have been in your Discord server.
inviteOnApprovalboolean | null
Whether approved applicants are invited to the server.
lastUpdatedinteger | null
When the form was last edited.
maxLogsinteger | null
Most punishment logs an applicant can have.
orgTypestring | null
Whether it belongs to a server or a department.
presetsobject | null
Saved reviewer reasons.
quizboolean | null
Whether the form is a quiz.
quizAutoAcceptThresholdinteger | null
Quiz score that approves automatically.
quizAutoDenyThresholdinteger | null
Quiz score that denies automatically.
quizReleaseTypeinteger | null
When quiz scores are released.
requireApprovedReasonboolean | null
Whether reviewers must give a reason to approve.
requireDiscordMemberboolean | null
Whether applicants must be in your Discord server.
requiredDenialReasonboolean | null
Whether reviewers must give a reason to deny.
requiredDiscordRolesobject | null
Discord roles applicants must have.
resultsChannelIdstring | null
Discord channel for results.
resultsMentionUserboolean | null
Whether results mention the applicant.
revealReviewerboolean | null
Whether applicants see who reviewed them.
reviewOnlyRolesobject | null
Roles that can review but not edit the form.
reviewerRolesobject | null
Roles that can review responses.
robloxGroupIdstring | null
Roblox group applicants must be in.
sendResponsesboolean | null
Whether applicants get a copy of their answers.
sharingstring | null
Who else the form is shared with.
slugstring | null
Short link slug.
stageResponsesboolean | null
Whether decisions are staged before they're finalized.
submissionMessagestring | null
Message shown after submitting.
submitMentionRolesobject | null
Discord roles mentioned on new submissions.
typeinteger | null
Form type.

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