Claimed quests lookup
Overview
Those two endpoints allow you to retrieve claimed quests.
The Review object
id - String
ID of the claimed quest
user - Object
Object containing the id, name, and avatar url of the user
quest - Object
Object containing id and name of the quest
status - Enum (success, fail, pending)
Status of the review
mark - Enum (star, flag)
This field defines if the review has been marked as a star or if the review has been flagged. It can be null if none of the actions have been performed.
tasks - Array of object
Contains the list of tasks the user completed, with the submissions if any. To know more about tasks, check our product docs.
updatedAt - String
ISO timestamp that indicates the last date at which the claimed quest was updated
createdAt - String
ISO timestamp that indicates the date at which the quest was claimed
The Task object
Common properties
The following properties are set in all task types
type - String
ID of the task
type - Enum
The possible values are: api, text, discord, url, telegram, quiz, invites, visitLink, file, date, number, poll, opinion, twitterFollow, twitterSpace, tweetReact, tweet, tiktok.
Status - Enum (error, success, in-review)
Status of the task
createdAt - String
ISO timestamp that indicates the date at which the task was completed
Exclusive properties
The following properties are only set in one or multiples task types.
value - String or Number
Value submitted by the user when completing the task. This property is set for the following task types: tiktok, opinion, number, date, url, text.
values - Array of String
Values submitted by the user when completing the task. Can hold one or multiple values. This property is set for the following task types: quiz, poll.
fileUrls - Array of String
This properties contains the URLs of the files a user submitted. This property is set for the task type file.
tweetId - String
This property contains the ID of the tweet the user submitted. This property is set for the task type tweet.
API Reference
200
400
401
403
404
409
429
500
GET /public/communities/{subdomain}/reviews/{id} HTTP/1.1
Host: api-v2.zealy.io
x-api-key: text
Accept: */*
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"user": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"avatar": "text",
"verifiedAddresses": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"quest": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text"
},
"status": "pending",
"mark": "star",
"lastReviewerId": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "text",
"updatedAt": "text",
"tasks": [
{
"id": "text",
"createdAt": "2025-08-26T20:16:20.115Z",
"status": "error",
"type": "onChain"
}
],
"autoValidated": true
}50^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3,6}Z)_([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$200
400
401
403
404
409
429
500
GET /public/communities/{subdomain}/reviews HTTP/1.1
Host: api-v2.zealy.io
x-api-key: text
Accept: */*
{
"items": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"user": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"avatar": "text",
"verifiedAddresses": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"quest": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text"
},
"status": "pending",
"mark": "star",
"lastReviewerId": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "text",
"updatedAt": "text",
"tasks": [
{
"id": "text",
"createdAt": "2025-08-26T20:16:20.115Z",
"status": "error",
"type": "onChain"
}
],
"autoValidated": true
}
],
"nextCursor": "text"
}Last updated
Was this helpful?