Skip to main content

Fetch quests for a project

GET 
/quests/by/project/:projectId

Fetch quests for a project

Request​

Path Parameters

    projectId projectIdrequired

    The projectId to get quests of

Query Parameters

    startDate date-time

    Search by start date

    endDate date-time

    Search by end date

    sortBy string

    Possible values: [createdAt, popularity, points]

    Field to order the results by (e.g., 'createdAt', 'points'). Default is 'createdAt'.

    sortOrder string

    Possible values: [asc, desc]

    Default value: desc

    'asc' for ascending or 'desc' for descending order. Default is 'desc'.

    state string

    The state of the fetched quests

    category string

    Field to filter results by quest categories (e.g. steam, youtube, tiktok).

    name string

    Field to filter results by quest function names (e.g. wishlist, tweet, ownedGame).

Responses​

Fetch quests of a project

Schema

  • Array [

    • questTypeId stringrequired

    Unique identifier for the QuestType

    descriptions string

    Detailed descriptions of the different stages/applications of the quest

    projectId projectId (string)required

    Unique identifier for Project

    userQuestsLimit integer

    Maximum allowed number of times for the quest to be completed by a single user

    points integerrequired

    Possible values: <= 1000000

    The amount of points you gain after finishing the quest

    thumbnail stringnullable

    URL to the quest's thumbnail image

    createdAt date-time

    Time representation of entity creation

    myUserQuestCount integer

    Number of times this quest has been completed by the current user

    name questName (string)required

    Possible values: <= 64 characters

    Name of the quest

    refereeQuestId stringnullable

    Unique identifier for the referee quest

    state questState (string)

    Possible values: [open, closed]

    id questId (string)

    Unique identifier for Quest

    periodic questPeriodic (string)

    Possible values: [daily, weekly, monthly, hourly]

    userQuestCount integer

    Number of times this quest has been completed.

    data string

    Quest-specific data in JSON format

    referrerQuestId string

    Unique identifier for the referrer quest

    prerequisites questId (string)[]nullable

    List of prerequisite quests that must be completed before starting this quest

  • ]

Loading...