Fetch quests for a project
GET/quests/by/project/:projectId
Fetch quests for a project
Request
Path Parameters
The projectId to get quests of
Query Parameters
Search by start date
Search by end date
Possible values: [createdAt
, popularity
, points
, rankOrder
]
Field to order the results by (e.g., 'createdAt', 'points'). Default is 'createdAt'.
Possible values: [asc
, desc
]
Default value: desc
'asc' for ascending or 'desc' for descending order. Default is 'desc'.
Possible values: [all
, stage
, nonStage
]
Specify whether to fetch stageQuests or not.
The state of the fetched quests
Field to filter results by quest categories (e.g. steam, youtube, tiktok).
Field to filter results by quest function names (e.g. wishlist, tweet, ownedGame).
Responses
- 200
- default
Fetch quests of a project
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Possible values: <= 64 characters
Name of the quest
Unique identifier for Quest
Unique identifier for the QuestType
Time representation of entity creation
The index of the last stage (0 if not a StagesQuest)
URL to the quest's thumbnail image
Unique identifier for the referee quest
Detailed descriptions of the different stages/applications of the quest
Number of times this quest has been completed by the current user
Possible values: [open
, closed
]
Number of times this quest has been completed.
Quest-specific data in JSON format
Possible values: <= 1000000
The amount of points you gain after finishing the quest
The order in which the quest should be displayed
List of prerequisite quests that must be completed before starting this quest
Unique identifier for Project
Unique identifier for the referrer quest
Maximum allowed number of times for the quest to be completed by a single user
Expiration date for the quest
Possible values: [daily
, weekly
, monthly
, hourly
]
[
{
"name": "Game referral",
"id": "q3b19Z1n",
"questTypeId": "Q3b19Z1n",
"createdAt": "2024-01-01T09:00:00.00Z",
"maxStage": 5,
"thumbnail": "https://file.playmakers.co/p2Duhf5N6/aUv0OhmsR.jpg",
"refereeQuestId": "Q3b19Z1n",
"descriptions": "{\"short\":\"wishlist BF4 in order to obtain your points\",\"pre\":[\"stage 1 desc\",\"stage 2 desc\"]}",
"myUserQuestCount": 2,
"state": "open",
"userQuestCount": 1,
"data": "string",
"points": 50,
"rankOrder": 1,
"prerequisites": [
"q3b19Z1n"
],
"projectId": "p2Duhf5N6",
"referrerQuestId": "Q3b19Z1n",
"userQuestsLimit": 3,
"expiresAt": "2025-01-01T09:00:00.00Z",
"periodic": "daily"
}
]
Unexpected error
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "An unexpected error occured"
}