Check quest progress

Triggers a quest progress check for the authenticated user. Accepts questType (preferred) or questId (legacy alias). The value is validated against a known set of quest progress actions (e.g. FOLLOW_USER, UPLOAD_PROFILE_PICTURE). Returns a rich status snapshot with completion state.

POST /api/quests/check-progress

Check quest progress

cURL

curl --request POST \
  --url https://app.d-sports.org/api/quests/check-progress \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "questType": "FOLLOW_USER",
  "questId": "<string>"
}
'

Authorizations

Authorization · string · header · required

Clerk session token. Use Authorization: Bearer .

Body

application/json

questType · enum<string>

Quest progress action to check. Accepts SCREAMING_SNAKE or snake_case.

Available options: FOLLOW_USER, UPLOAD_PROFILE_PICTURE, CHOOSE_TEAM, COMPLETE_PROFILE, GET_FOLLOWER, JOIN_LEADERBOARD, EARN_POINTS, UPDATE_LEADERBOARD_POSITION

questId · string

Legacy alias for questType. Use questType instead.

Response

200

{ success: true, data: { message, status, actionStatus } }