Get tier configuration
GET
/v1/xp-settings/tiers-info
What this endpoint does
data object means this community has no tiers configured, not that the route failed.INFO
GET /v1/xp-settings/tiers-info?communityId=<communityId> → if data is {}, there are no tiers to compare against member XP.Quick start
communityId is required. Omitting it returns 400.Authentication and permission
getTiersInfo. The communityId query must match the key's community. Keep the key server-side.Complete examples
message is Tiers info fetched successfully. data may be {} when no tiers exist.{ "status": "error", "message": "Community ID is required" }.Success and readback
200. Repeat after admin changes tiers. This GET is the readback for tier configuration.Errors and recovery
| Status | When | Recovery |
|---|---|---|
400 Community ID is required | No communityId | Add the 24-character community ObjectId. |
401 | Missing or invalid token | Add a valid community key with getTiersInfo. |
Retry safety
TIP
Gotchas
communityId and expect the key to fill it in.data is success.Next steps
Request
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://adss-integration.returning.ai/apis/v1/xp-settings/tiers-info?communityId=64b7f3a2c8d4e6f102938475' \
--header 'Authorization: Bearer <COMMUNITY_API_KEY>'Response Response Example
200 - Configured tiers
{
"status": "success",
"message": "Tiers info fetched successfully",
"data": {
"Explorer": {
"Bronze": "0 XP",
"Silver": "500 XP",
"Gold": "1500 XP"
},
"Challenger": {
"Bronze": "3000 XP",
"Silver": "6000 XP",
"Gold": "10000 XP"
},
"Champion": {
"Bronze": "15000 XP",
"Silver": "22000 XP",
"Gold": "30000 XP"
}
}
}Modified at 2026-08-19 13:44:36