The User Quest API provides a comprehensive set of endpoints for users to interact with quests you have created. These endpoints provide current and historical quest data and quest participation data.
The Quest Details API provides detailed information about a specific quest, including its type, status, rewards, and more.
Get quest details
get
Path parameters
questIdstringRequired
Query parameters
includeStreakbooleanOptional
Include the users current streak (if quest is recurring)
Responses
400
Generic Client Error
application/json
401
Authentication related errors:
- `GENERIC_UNAUTHORIZED`: Generic unauthorized access error.
- `SESSION_TOKEN_EXPIRED`: User session has expired.
- `REFRESH_TOKEN_EXPIRED`: Refresh token has expired.
application/json
404
Generic not found
application/json
500
Internal server error
application/json
default
application/json
get
GET /v1/quests/{questId} HTTP/1.1
Host:
Accept: */*
Used to initiate the stat tracking on a quest that requires it
Path parameters
questIdstringRequired
Body
objectOptional
Responses
400
Generic Client Error
Errors related to quest completion:
- `QUEST_ALREADY_COMPLETED`: Quest has already been completed.
- `ATTEMPT_LIMIT_REACHED`: You have reached the maximum number of attempts for this quest.
- `QUEST_CONDITION_NOT_COMPLETED`: Quest condition has not been completed.
- `QUEST_CONDITION_CHECK_FAILED`: Failed to check quest condition.
- `BATTLENET_AUTH_EXPIRED`: Battle.net authentication has expired.
- `HANDLER_BAD_REQUEST`: Invalid request to handler.
- `GAME_QUEST_BAD_REQUEST`: Invalid game quest request.
- `QUEST_BAD_REQUEST`: Invalid quest request.
- `CHARACTER_DATA_NOT_FOUND`: Character data could not be found.
- `SOCIAL_NOT_FOUND`: Social data not found.
- `INVALID_SNAPSHOT`: The received api snapshot is invalid.
- `HANDLER_INVALID_SNAPSHOT`: The provided snapshot is invalid.
- `SNAPSHOT_ACCOUNTS_DONT_MATCH`: The snapshot accounts do not match.
- `HANDLER_DATA_NOT_FOUND`: Handler data could not be found.
- `QUEST_CLOSED`: Quest is closed.
- `QUEST_UNPUBLISHED`: Quest is not published.
- `QUEST_NOT_COMPLETED`: Quest requirements not met.
- `HANDLER_EMPTY_TEXT`: Empty text provided.
- `HANDLER_FORBIDDEN`: Action forbidden.
- `OAUTH_TOKEN_REFRESH_FAILED`: OAuth token refresh failed.
- `DATA_NOT_PUBLIC`: User data is not publicly accessible.
- `NEW_OR_NOT_PUBLIC_DATA`: User is new or data is not publicly accessible.
- `HANDLER_AUTH_EXPIRED`: Game handler authentication has expired.
application/json
401
Authentication related errors:
- `GENERIC_UNAUTHORIZED`: Generic unauthorized access error.
- `SESSION_TOKEN_EXPIRED`: User session has expired.
- `REFRESH_TOKEN_EXPIRED`: Refresh token has expired.
Used to refresh the stat tracking on a previously accepted quest
Path parameters
questIdstringRequired
Responses
400
Generic Client Error
Errors related to quest completion:
- `QUEST_ALREADY_COMPLETED`: Quest has already been completed.
- `ATTEMPT_LIMIT_REACHED`: You have reached the maximum number of attempts for this quest.
- `QUEST_CONDITION_NOT_COMPLETED`: Quest condition has not been completed.
- `QUEST_CONDITION_CHECK_FAILED`: Failed to check quest condition.
- `BATTLENET_AUTH_EXPIRED`: Battle.net authentication has expired.
- `HANDLER_BAD_REQUEST`: Invalid request to handler.
- `GAME_QUEST_BAD_REQUEST`: Invalid game quest request.
- `QUEST_BAD_REQUEST`: Invalid quest request.
- `CHARACTER_DATA_NOT_FOUND`: Character data could not be found.
- `SOCIAL_NOT_FOUND`: Social data not found.
- `INVALID_SNAPSHOT`: The received api snapshot is invalid.
- `HANDLER_INVALID_SNAPSHOT`: The provided snapshot is invalid.
- `SNAPSHOT_ACCOUNTS_DONT_MATCH`: The snapshot accounts do not match.
- `HANDLER_DATA_NOT_FOUND`: Handler data could not be found.
- `QUEST_CLOSED`: Quest is closed.
- `QUEST_UNPUBLISHED`: Quest is not published.
- `QUEST_NOT_COMPLETED`: Quest requirements not met.
- `HANDLER_EMPTY_TEXT`: Empty text provided.
- `HANDLER_FORBIDDEN`: Action forbidden.
- `OAUTH_TOKEN_REFRESH_FAILED`: OAuth token refresh failed.
- `DATA_NOT_PUBLIC`: User data is not publicly accessible.
- `NEW_OR_NOT_PUBLIC_DATA`: User is new or data is not publicly accessible.
- `HANDLER_AUTH_EXPIRED`: Game handler authentication has expired.
application/json
401
Authentication related errors:
- `GENERIC_UNAUTHORIZED`: Generic unauthorized access error.
- `SESSION_TOKEN_EXPIRED`: User session has expired.
- `REFRESH_TOKEN_EXPIRED`: Refresh token has expired.
application/json
404
Generic not found
application/json
500
Internal server error
application/json
default
application/json
post
POST /v1/quests/{questId}/refresh HTTP/1.1
Host:
Accept: */*
Used to complete any quest whose conditions have been met.
Path parameters
questIdstringRequired
Body
objectOptional
Responses
400
Generic Client Error
Errors related to quest completion:
- `QUEST_ALREADY_COMPLETED`: Quest has already been completed.
- `ATTEMPT_LIMIT_REACHED`: You have reached the maximum number of attempts for this quest.
- `QUEST_CONDITION_NOT_COMPLETED`: Quest condition has not been completed.
- `QUEST_CONDITION_CHECK_FAILED`: Failed to check quest condition.
- `BATTLENET_AUTH_EXPIRED`: Battle.net authentication has expired.
- `HANDLER_BAD_REQUEST`: Invalid request to handler.
- `GAME_QUEST_BAD_REQUEST`: Invalid game quest request.
- `QUEST_BAD_REQUEST`: Invalid quest request.
- `CHARACTER_DATA_NOT_FOUND`: Character data could not be found.
- `SOCIAL_NOT_FOUND`: Social data not found.
- `INVALID_SNAPSHOT`: The received api snapshot is invalid.
- `HANDLER_INVALID_SNAPSHOT`: The provided snapshot is invalid.
- `SNAPSHOT_ACCOUNTS_DONT_MATCH`: The snapshot accounts do not match.
- `HANDLER_DATA_NOT_FOUND`: Handler data could not be found.
- `QUEST_CLOSED`: Quest is closed.
- `QUEST_UNPUBLISHED`: Quest is not published.
- `QUEST_NOT_COMPLETED`: Quest requirements not met.
- `HANDLER_EMPTY_TEXT`: Empty text provided.
- `HANDLER_FORBIDDEN`: Action forbidden.
- `OAUTH_TOKEN_REFRESH_FAILED`: OAuth token refresh failed.
- `DATA_NOT_PUBLIC`: User data is not publicly accessible.
- `NEW_OR_NOT_PUBLIC_DATA`: User is new or data is not publicly accessible.
- `HANDLER_AUTH_EXPIRED`: Game handler authentication has expired.
application/json
401
Authentication related errors:
- `GENERIC_UNAUTHORIZED`: Generic unauthorized access error.
- `SESSION_TOKEN_EXPIRED`: User session has expired.
- `REFRESH_TOKEN_EXPIRED`: Refresh token has expired.
Upon successful completion of a quest a user will be allocated tickets that can be used to claim rewards associated to the quest. The allocation endpoints return information about these tickets and previously submitted requirement data that fulfils configured requirements.
List rewards allocated to a user for a quest
get
Path parameters
questIdstringRequired
Responses
400
Generic Client Error
application/json
401
Authentication related errors:
- `GENERIC_UNAUTHORIZED`: Generic unauthorized access error.
- `SESSION_TOKEN_EXPIRED`: User session has expired.
- `REFRESH_TOKEN_EXPIRED`: Refresh token has expired.
application/json
404
Generic not found
application/json
500
Internal server error
application/json
default
application/json
get
GET /v1/quests/{questId}/reward/allocations HTTP/1.1
Host:
Accept: */*