Details
The Quest Events API provides a comprehensive set of endpoints to interact with quest events a community has created.
Quest Event
Path parameters
eventIdstringRequired
The id or slug of the event
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/quest-event/{eventId} HTTP/1.1
Host:
Accept: */*
{
"code": 10002,
"message": "generic_client_error"
}
Quest Events
Retrieve a list of events. Flags can be combined to return events open to register or/and with user participating.
Query parameters
pagenumberOptional
limitnumberOptional
participatingbooleanOptional
Return only events the user is participating in
registrationOpenbooleanOptional
Return only events open to register
filterobjectOptionalExample:
Additional filters for the events
{"containerId":"containerId","features":"true","status":["active","completed"]}
itemIdstringOptional
Filter events by itemId
resourceIdstringOptional
Filter events by resourceId
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/quest-event HTTP/1.1
Host:
Accept: */*
{
"code": 10002,
"message": "generic_client_error"
}
Quest Event Leaderboard
Path parameters
idstringRequired
Query parameters
pagenumberOptional
limitnumberOptional
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/quest-event/{id}/leaderboard HTTP/1.1
Host:
Accept: */*
{
"code": 10002,
"message": "generic_client_error"
}
Quest Event Quests
Path parameters
idstringRequired
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/quest-event/{id}/quests HTTP/1.1
Host:
Accept: */*
{
"code": 10002,
"message": "generic_client_error"
}
Quest Event Rewards
Upon successful completion of a quest event a user will be allocated tickets that can be used to claim rewards associated to the quest event. The allocation endpoints return information about these tickets and previously submitted requirement data that fulfils configured requirements.
Get Reward Allocations
Path parameters
eventIdstringRequired
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/quest-event/{eventId}/reward/allocations HTTP/1.1
Host:
Accept: */*
{
"code": 10002,
"message": "generic_client_error"
}
Claim Reward Allocation
Path parameters
rewardAllocationIdstringRequired
Body
emailstringOptional
walletAddressstringOptional
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
post
POST /v1/quest-event/{eventId}/reward/allocations/claim/{rewardAllocationId} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 202
{
"email": "text",
"walletAddress": "text",
"address": {
"addressId": "text",
"addressLine1": "text",
"addressLine2": "text",
"addressLine3": "text",
"city": "text",
"state": "text",
"postalCode": "text",
"country": "text"
}
}
{
"code": 10002,
"message": "generic_client_error"
}
Last updated