List quests

Overview

This endpoint retrieves all quests and their details for a specified community. Admin role required.

The claimCounter indicates the number of claims made for a quest. Note: this value is not real-time; it is cached for 1 hour.

List quests in a community

get

Path parameters

subdomainstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200

application/json

idstringRequired

namestringRequired

deletedbooleanOptional

communityIdstringOptional

categoryIdstringOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

archivedboolean · nullableRequired

autoValidatebooleanOptional

conditionOperatorstring · enum · nullableRequiredPossible values:

publishedbooleanRequired

recurrencestring · enumRequiredPossible values:

retryAfternumber · nullableRequired

claimLimitnumber · nullableOptional

claimCounternumber · nullableOptional

400

400

application/json

401

401

application/json

403

403

application/json

404

404

application/json

409

409

application/json

429

429

application/json

500

500

application/json

get

/public/communities/{subdomain}/quests

HTTPcURLJavaScriptPython

GET /public/communities/{subdomain}/quests HTTP/1.1
Host: api-v2.zealy.io
x-api-key: text
Accept: */*

[
  {
    "description": {
      "type": "text",
      "text": "text",
      "attrs": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "marks": [
        {
          "type": "text",
          "attrs": {
            "href": "text",
            "target": "_blank",
            "class": "text",
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "content": null,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "id": "text",
    "name": "text",
    "deleted": true,
    "communityId": "text",
    "categoryId": "text",
    "createdAt": "2026-03-01T13:33:11.092Z",
    "updatedAt": "2026-03-01T13:33:11.092Z",
    "archived": true,
    "autoValidate": true,
    "conditionOperator": "AND",
    "conditions": [
      {
        "type": "level",
        "value": "text",
        "operator": "="
      }
    ],
    "published": true,
    "recurrence": "daily",
    "retryAfter": 1,
    "rewards": [
      {
        "type": "xp",
        "operator": "=",
        "value": "text",
        "chain": "polygon",
        "collection": "text",
        "contractAddress": "text"
      }
    ],
    "tasks": [
      {
        "id": "text",
        "metadata": null,
        "type": "api",
        "settings": {
          "title": "text",
          "description": "text",
          "endpoint": "https://example.com",
          "apiKey": "text",
          "identifications": [
            "email"
          ],
          "network": "eth-mainnet",
          "redirectUrl": "text"
        }
      }
    ],
    "claimLimit": 1,
    "claimCounter": 1
  }
]