Gamearly API v1
Dashboard

Quests / Quest verification

Quest verification#

There are two paths to mark tasks complete.

1. Manual verification#

The player clicks Verify in Gamearly.

  • Gamearly calls your verification endpoint, whose URL you configure in project settings.
  • We send a signed request containing:

    {
      "task_id": 123,
      "partner_user_id": "A1B2C3"
    }
    
  • Your endpoint responds with:

    {
      "task_id": 123,
      "partner_user_id": "A1B2C3",
      "completed": true
    }
    
  • If completed is true, the task is marked complete.

2. Automatic verification#

Optional, but recommended. Your project proactively reports task completion to Gamearly via the /quests/complete_task endpoint.

This gives a smoother player experience and reduces the need for manual verification.

Note

Once all tasks in a quest are completed, the quest is automatically marked as completed and the player can claim their rewards.

Checking completion#

If a player links their account after completing something, you can check state on demand:

Finding a quest id

The quest id is in the URL of the quest on Gamearly — e.g. https://app.gamearly.com/quests/27 — or from the /quests/list endpoint.